Blob


1 .fp 1 R LuxiSans
2 .fp 2 I LuxiSans-Oblique
3 .fp 3 B LuxiSans-Bold
4 .fp 4 BI LuxiSans-BoldOblique
5 .fp 5 L LuxiMono
6 .ds 9 /usr/local/plan9
7 .if n .uf 4
8 .if n .bd 3
9 .if n .rm bd
10 '''\" PWB Manual Entry Macros - 1.36 of 11/11/80
11 '''\" Nroff/Troff Version @(#)1.36
12 '''\" Option -rs1 short (9") pages
13 '''\" Option -rp# set no. of first page, put no. of pgs. on stderr
14 '''\" Option -rd1 give modified date instead of printed date
15 ... temporary fixes for neat manual printing...
16 .deth
17 .tmwrong version of man entry macros - use -man6
18 .ab
19 ..
20 .ifn .ds Tm \uTM\d
21 .ift .ds Tm \v'-0.5m'\s-4TM\s+4\v'0.5m'
22 .de}E
23 .}f
24 .in\\n()Ru+\\n(INu
25 .ll\\n(LLu
26 .lt\\n(LLu
27 .pl\\n()Lu
28 ..
29 .deDT
30 .ift .ta 3.6m 7.2m 10.8m 14.4m 18m 21.6m 25.2m 28.8m 32.4m 36m 39.6m 43.2m 46.8m
31 .ifn .ta 5n 10n 15n 20n 25n 30n 35n 40n 45n 50n 55n 60n 65n
32 ..
33 .de HY
34 .hy14
35 ..
36 .de}f
37 .ift .vs \\n()Vp
38 .ps\\n()S
39 .ft1
40 ..
41 .de}H
42 .ev1
43 .}C
44 .}E
45 .ie\\n()s 'sp |2v
46 .el'sp |3v
47 .".ps\\n()S-1
48 .tl \\*(]H\\*(]L\\*(]H
49 .ft1
50 .ps\\n()S
51 .ie\\n()s 'sp 1.5v
52 .el'sp 3v
53 .ev
54 .ns
55 .if \\n(CL .2C
56 ..
57 .de}F
58 .ev1
59 .}E
60 .if\\n()s 'sp |\\n(.pu-1v-1p
61 .if\\n()t 'sp |\\n(.pu-3v
62 .ifn 'sp |\\n(.pu-4v
63 .ifn .tl Page %\\*(]D\\*(]W
64 .ift .tl %
65 .ev
66 'bp
67 ..
68 .ifn .ig
69 .de}C
70 .if "\\*(.T"aps"\{\
71 . po0i
72 . lt7.5i
73 . if\\n()s .tl \l0.25i\l0.25i\h1i\l0.25i
74 . if\\n()t .tl \l0.25i\l0.25i
75 . lt
76 . po\}
77 ..
78 .de}M
79 .}N
80 .wh-.5p }C
81 .ll\\n(LLu
82 .}P
83 ..
84 .de}K
85 .}N
86 .pl1
87 .ll\\n(LLu
88 ..
89 .de}P
90 .nr )P \\n%+1-\\np
91 .if \\nq .tm \\n(.F \\n()P \\np
92 .bp
93 .if \\nq .nr p \\n%
94 ..
95 .deTH
96 .PD
97 .nrIN \\n()Mu
98 .ift .ds ]H \\$1\^(\^\\$2\^)
99 .ifn .ds ]H \\$1(\\$2)
100 .if\\n()s .ds ]D
101 .if\\n()t .ds ]D Plan 9
102 .ifn .ds ]D Plan 9
103 .ds]L
104 .if!\\$3 .ds ]L (\^\\$3\^)
105 .if!\\$4 .ds ]D \\$4
106 .wh0 }H
107 .wh-\\n(:mu }F
108 .em}M
109 .if\\n(nl .}P
110 .nr)I \\n()Mu
111 .nr)R 0
112 .}E
113 .DT
114 .ifn \{.na
115 .nh\}
116 .ift \{.bd S 3 3
117 .HY \}
118 \Xhtml <B>
119 \Xhtml [<A HREF="/sys/man/index.html">manual index</A>]
120 \Xhtml [<A HREF="/sys/man/\\$2/INDEX.html">section index</A>]
121 \Xhtml </B>
122 ..
123 .de HR
124 .ie '\\$2'' \\$4\X'html href \\$1'\fL\\$1\fP\X'html /href'\\$3
125 .el \\$4\X'html href \\$1'\\$2\X'html /href'\\$3
126 ..
127 .deSH
128 .PD
129 .}X 0 "\\$1"
130 .nr)E 2
131 \&\Xhtml <H4>\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\Xhtml </H4>
132 ..
133 .deSS
134 .PD
135 .}X 3n "" ""
136 .nr)E 2
137 \Xhtml <H4>\&\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\Xhtml </H4>
138 ..
139 .de}X
140 .}E
141 .ti\\$1
142 .sp\\n(PDu
143 .ne1.1v
144 .nr)R 0
145 .fi
146 '''ss12
147 '''if\\$2SYNOPSIS .ss 18
148 .it1 }N
149 .if!\\$3 .SM
150 .ft 3
151 ..
152 .de}2
153 .nr)E 0
154 .}E
155 .nr)I \\n()Mu
156 .ns
157 .ft1
158 ..
159 .deSM
160 .nh
161 .ps\\n()S-1
162 .if!\\$1 \&\\$1
163 .if!\\$2 \&\\$2
164 .if!\\$3 \&\\$3
165 .if!\\$4 \&\\$4
166 .if!\\$5 \&\\$5
167 .if!\\$6 \&\\$6
168 .if!\\$1 .ps \\n()S
169 .if\\$1 .it 1 }N
170 .HY
171 ..
172 .deI
173 .nh
174 .ft2
175 .it1 }N
176 .if!\\$1 \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
177 .HY
178 ..
179 .deB
180 .nh
181 .it1 }N
182 .ie!\\$1 \%\&\f5\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
183 .el .ft5
184 .HY
185 ..
186 .deL
187 .nh
188 .it1 }N
189 .ift \{.ie!\\$1 \%\&\f5\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
190 .el .ft5 \}
191 .ifn \{.ft5
192 .if!\\$1 \{.ie\\$2 `\\$1'
193 .el .ie\\$3 `\\$1 \\$2'
194 .el .ie\\$4 `\\$1 \\$2 \\$3'
195 .el .ie\\$5 `\\$1 \\$2 \\$3 \\$4'
196 .el .ie\\$6 `\\$1 \\$2 \\$3 \\$4 \\$5'
197 .el `\\$1 \\$2 \\$3 \\$4 \\$5 \\$6'\}\}
198 .HY
199 ..
200 .deRI
201 .nh
202 .}S 1 2 \& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
203 .HY
204 .}f
205 ..
206 .deIR
207 .nh
208 .}S 2 1 \& "\Xhtml manref start \\$1 \\$2\\$1" "\\$2\Xhtml manref end \\$1 \\$2" "\\$3" "\\$4" "\\$5" "\\$6"
209 .HY
210 .}f
211 ..
212 .deIB
213 .nh
214 .ift .}S 2 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
215 .ifn .}S 2 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
216 .HY
217 .}f
218 ..
219 .deRB
220 .nh
221 .ift .}S 1 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
222 .ifn .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
223 .HY
224 .}f
225 ..
226 .deBR
227 .nh
228 .ift .}S 5 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
229 .ifn .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
230 .HY
231 .}f
232 ..
233 .deBI
234 .nh
235 .ift .}S 5 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
236 .ifn .}S 1 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
237 .HY
238 .}f
239 ..
240 .de LR
241 .nh
242 .ift \%\&\f5\\$1\f1\\$2
243 .ifn \%`\\$1'\\$2
244 .HY
245 ..
246 .de RL
247 .nh
248 .ift \%\&\f1\\$1\\f5\\$2\\f1\\$3
249 .ifn \%\\$1`\\$2'\\$3
250 .HY
251 ..
252 .de}S
253 .ds]F
254 .if\\$12 .if !\\$5 .ds ]F \^
255 .if\\$22 .if !\\$5 .ds ]F \^
256 .ie!\\$4 .}S \\$2 \\$1 "\\$3\f\\$1\\$4\\*(]F" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
257 .el\\$3
258 .}f
259 ..
260 .deEX
261 .ift .ft5
262 .nf
263 ..
264 .deEE
265 .ft1
266 .fi
267 ..
268 .de}p
269 .sp\\n(PDu
270 .ne1.1v
271 .}E
272 .nr)I \\n()Mu
273 .ns
274 ..
275 .dePP \"indirect PP so we can attach html - see tmac.anhtml
276 .}p
277 ..
278 .deP
279 .PP
280 ..
281 .deLP
282 .PP
283 ..
284 .dePD
285 .ift .nr PD .4v
286 .ifn .nr PD 1v
287 .if!\\$1 .nr PD \\$1v
288 ..
289 .deHP
290 .sp\\n(PDu
291 .ne1.1v
292 .if!\\$1 .nr )I \\$1n
293 .ll\\n(LLu
294 .in\\n()Ru+\\n(INu+\\n()Iu
295 .ti\\n()Ru+\\n(INu
296 .}f
297 ..
298 .deIP
299 .ie!\\$1 \{.TP "\\$2"
300 \&\\$1\}
301 .el\{.sp\\n(PDu
302 .ne1.1v
303 .if!\\$2 .nr )I \\$2n
304 .}f
305 .ll\\n(LLu
306 .in\\n()Ru+\\n(INu+\\n()Iu
307 .lg\}
308 ..
309 .deTP
310 .if!\\$1 \{.nr )I \\$1n
311 .if\\$10 .nr )I \\n()M\}
312 .sp\\n(PDu
313 .ne1.1v
314 .in\\n()Ru
315 .lg0
316 .ns
317 .it1 }N
318 .nr)E 1
319 .di]B
320 ..
321 .deTF
322 .IP "" "\w'\f5\\$1\ \ \fP'u"
323 .PD0
324 ..
325 .de}1
326 .ds]X \&\\*(]B\\
327 .rm]B
328 .nr)E 0
329 .if!\\$1 .nr )I \\$1n
330 .}f
331 .ll\\n(LLu
332 .in\\n()Ru+\\n(INu+\\n()Iu
333 .ti\\n(INu
334 .ie!\\n()Iu+\\n()Ru-\w\\*(]Xu-3p \{\\*(]X
335 .br\}
336 .el\\*(]X\h|\\n()Iu+\\n()Ru\c
337 .}f
338 .lg
339 ..
340 .de}N
341 .if\\n()E .br
342 .if\\n()E1 .di
343 .if\\n()E0 .}f
344 .if\\n()E1 .}1
345 .if\\n()E2 .}2
346 ..
347 .deRS
348 .nr]\\n+()p \\n()I
349 .nr)\\n()p \\n()R
350 .ie!\\$1 .nr )R +\\$1n
351 .el.nr )R +\\n()I
352 .nr)I \\n()Mu
353 .}E
354 ..
355 .deRE
356 .if!\\$1 \{.ie \\$10 .nr )p 1 1
357 .el.nr )p \\$1 1 \}
358 .ds]i \\*(]I\\n()p
359 .ds]r \\*(]R\\n()p
360 .nr)I \\*(]i
361 .nr)R \\*(]r
362 .if\\n()p .nr )p -1
363 .}E
364 ..
365 '''\" .2C begin 2-column display, by diversion
366 '''\" CC=amount of text that will fit on page
367 '''\" CL=1 multicolumn in effect, else 0
368 '''\" CI saved indent
369 '''\" CB contains diverted text
370 .de 2C
371 .ne 2
372 .nf
373 .nr CC \\n(.t/1v*2v
374 .nr CI \\n(IN
375 .nr IN 0
376 .di CB
377 .nr CL 1
378 .}E
379 .dt \\n(CCu C1
380 ..
381 '''\" .1C return to 1-column
382 .de 1C
383 .nr CL 0
384 .C1
385 .fi
386 ..
387 '''\" end of diversion, at end of page or return to 1-column
388 '''\" CC=pos of nominal column end
389 .de C1
390 .dt
391 \!.C3
392 .di
393 .if \\n(dn \{.nr CC \\n(dnu/2u+\\n(nlu
394 .wh \\n(CCu C2
395 .mk
396 .nf
397 .nr IN \\n(CIu
398 .}E
399 .CB \}
400 ..
401 '''\" end of first column retrieved from diversion
402 '''\" CC=pos of actual column end
403 .de C2
404 .wh \\n(CCu
405 .mk CC
406 .po +(\\n(LLu/2u)u
407 .rt
408 .if \\n(dn>1v .ns
409 ..
410 '''\" end of second column
411 .de C3
412 .br
413 .po -(\\n(LLu/2u)u
414 .if \\n(CC>\\n(nl .sp |\\n(CCu
415 .ne 2
416 ..
417 .dePM
418 .if\\$1 .nr !K 0
419 .if\w\\$1 \{\
420 .ie\\$1P .nr !K 1
421 .el.ie \\$1BP .nr !K 3
422 .el.ie \\$1BR .nr !K 4
423 .el.nr !K 2 \}
424 .if\\n(!K .wh -(\\n(:mu+5v) )G
425 ..
426 .de)G
427 .if\\n(!K 'sp 2v
428 .ie\\n(!K=1 \{\
429 .iet .bd1 3
430 .el.bd1 0
431 .tlPRIVATE
432 .bd1
433 .tlThis information should not be disclosed to unauthorized persons.
434 .tlIt is meant solely for use by authorized Bell System employees. \}
435 .el.ie \\n(!K=3 \{\
436 .iet .bd1 3
437 .el.bd1 0
438 .tlBELL LABORATORIES PROPRIETARY
439 .bd1
440 .tlNot for use or disclosure outside Bell Laboratories except by
441 .tlwritten approval of the director of the distributing organization. \}
442 .el.ie \\n(!K=4 \{\
443 .iet .bd1 3
444 .el.bd1 0
445 .tlBELL LABORATORIES RESTRICTED
446 .bd1
447 .tlThe information herein is meant solely for use by authorized
448 .tlBell Laboratories employees and is not to be disclosed to others. \}
449 .el.if \\n(!K=2 \{\
450 .iet .bd1 3
451 .el.bd1 0
452 .tlNOTICE
453 .bd1
454 .tlNot for use or disclosure outside the
455 .tlBell System except under written agreement. \}
456 ..
457 .nr)s 0
458 .ift .if \ns .nr )s 1
459 .nr)t 0
460 .ift .if !\ns .nr )t 1
461 .if\n()s \{.nr )L 9i
462 .nrLL 4.75i
463 .nr)O .75i
464 .nr)S 8
465 .nr)V 9 \}
466 .if\n()t \{.nr )L 11i
467 .nrLL 6.5i
468 .nr)O 1i
469 .nr)S 9
470 .nr)V 11 \}
471 .ift \{.ds R ®
472 .dsS \s\n()S
473 ..\}
474 .ifn \{.nr )L 11i
475 .nrLL 6.5i
476 .nr)O .463i
477 .if '\*(.T'think' \{.nrLL 80n
478 .nr)O 0\}
479 .if '\*(.T'thinksmall' \{.nrLL 142n
480 .vs 9p
481 .nr)O 0\}
482 .dsR (Reg.)
483 .dsS
484 ..\}
485 .if\nT .nr LL 80n
486 .if\nV>1 \{
487 .nrLL 82n
488 .nr)L 84v
489 .rmul \}
490 .nr)p 0 1
491 .ds]I \\\\n(]
492 .ds]R \\\\n()
493 .if\nd0 .nr m \n(mo-1
494 .if\nm0 .ds ]m January
495 .if\nm1 .ds ]m February
496 .if\nm2 .ds ]m March
497 .if\nm3 .ds ]m April
498 .if\nm4 .ds ]m May
499 .if\nm5 .ds ]m June
500 .if\nm6 .ds ]m July
501 .if\nm7 .ds ]m August
502 .if\nm8 .ds ]m September
503 .if\nm9 .ds ]m October
504 .if\nm10 .ds ]m November
505 .if\nm11 .ds ]m December
506 .ifn \{.nr m \nm+1
507 .nr yD (\n(yr%100
508 .af yD 01
509 .ie\nd .ds ]W (last mod. \nm/\nd/\ny)
510 .el.ds ]W (printed \n(mo/\n(dy/\n(yD)
511 ..\}
512 .if\n()s .ds ]W
513 .if\n()t \{.ie \nd .ds ]W \*(]m \nd, 20\ny
514 .el.ds ]W \*(]m \n(dy, 20\n(yr
515 ..\}
516 .pl\n()Lu
517 .ll\n(LLu
518 .lt\n(LLu
519 .po\n()Ou
520 .ift .tr \``\''
521 .}f
522 .if\n()s .nr :m 3.5v
523 .if\n()t .nr :m 6v
524 .ifn .nr :m 7v
525 .ift .nr )M 3.6m
526 .ifn .nr )M 5n
527 .em}K
528 .nr q \np
529 .if!\np .nr p 1
530 .pn \np