Blob


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