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 .deSH
123 .PD
124 .}X 0 "\\$1"
125 .nr)E 2
126 \&\Xhtml <H4>\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\Xhtml </H4>
127 ..
128 .deSS
129 .PD
130 .}X 3n "" ""
131 .nr)E 2
132 \Xhtml <H4>\&\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\Xhtml </H4>
133 ..
134 .de}X
135 .}E
136 .ti\\$1
137 .sp\\n(PDu
138 .ne1.1v
139 .nr)R 0
140 .fi
141 '''ss12
142 '''if\\$2SYNOPSIS .ss 18
143 .it1 }N
144 .if!\\$3 .SM
145 .ft 3
146 ..
147 .de}2
148 .nr)E 0
149 .}E
150 .nr)I \\n()Mu
151 .ns
152 .ft1
153 ..
154 .deSM
155 .nh
156 .ps\\n()S-1
157 .if!\\$1 \&\\$1
158 .if!\\$2 \&\\$2
159 .if!\\$3 \&\\$3
160 .if!\\$4 \&\\$4
161 .if!\\$5 \&\\$5
162 .if!\\$6 \&\\$6
163 .if!\\$1 .ps \\n()S
164 .if\\$1 .it 1 }N
165 .HY
166 ..
167 .deI
168 .nh
169 .ft2
170 .it1 }N
171 .if!\\$1 \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
172 .HY
173 ..
174 .deB
175 .nh
176 .it1 }N
177 .ie!\\$1 \%\&\f5\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
178 .el .ft5
179 .HY
180 ..
181 .deL
182 .nh
183 .it1 }N
184 .ift \{.ie!\\$1 \%\&\f5\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
185 .el .ft5 \}
186 .ifn \{.ft5
187 .if!\\$1 \{.ie\\$2 `\\$1'
188 .el .ie\\$3 `\\$1 \\$2'
189 .el .ie\\$4 `\\$1 \\$2 \\$3'
190 .el .ie\\$5 `\\$1 \\$2 \\$3 \\$4'
191 .el .ie\\$6 `\\$1 \\$2 \\$3 \\$4 \\$5'
192 .el `\\$1 \\$2 \\$3 \\$4 \\$5 \\$6'\}\}
193 .HY
194 ..
195 .deRI
196 .nh
197 .}S 1 2 \& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
198 .HY
199 .}f
200 ..
201 .deIR
202 .nh
203 .}S 2 1 \& "\Xhtml manref start \\$1 \\$2\\$1" "\\$2\Xhtml manref end \\$1 \\$2" "\\$3" "\\$4" "\\$5" "\\$6"
204 .HY
205 .}f
206 ..
207 .deIB
208 .nh
209 .ift .}S 2 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
210 .ifn .}S 2 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
211 .HY
212 .}f
213 ..
214 .deRB
215 .nh
216 .ift .}S 1 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
217 .ifn .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
218 .HY
219 .}f
220 ..
221 .deBR
222 .nh
223 .ift .}S 5 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
224 .ifn .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
225 .HY
226 .}f
227 ..
228 .deBI
229 .nh
230 .ift .}S 5 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
231 .ifn .}S 1 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
232 .HY
233 .}f
234 ..
235 .de LR
236 .nh
237 .ift \%\&\f5\\$1\f1\\$2
238 .ifn \%`\\$1'\\$2
239 .HY
240 ..
241 .de RL
242 .nh
243 .ift \%\&\f1\\$1\\f5\\$2\\f1\\$3
244 .ifn \%\\$1`\\$2'\\$3
245 .HY
246 ..
247 .de}S
248 .ds]F
249 .if\\$12 .if !\\$5 .ds ]F \^
250 .if\\$22 .if !\\$5 .ds ]F \^
251 .ie!\\$4 .}S \\$2 \\$1 "\\$3\f\\$1\\$4\\*(]F" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
252 .el\\$3
253 .}f
254 ..
255 .deEX
256 .ift .ft5
257 .nf
258 ..
259 .deEE
260 .ft1
261 .fi
262 ..
263 .de}p
264 .sp\\n(PDu
265 .ne1.1v
266 .}E
267 .nr)I \\n()Mu
268 .ns
269 ..
270 .dePP \"indirect PP so we can attach html - see tmac.anhtml
271 .}p
272 ..
273 .deP
274 .PP
275 ..
276 .deLP
277 .PP
278 ..
279 .dePD
280 .ift .nr PD .4v
281 .ifn .nr PD 1v
282 .if!\\$1 .nr PD \\$1v
283 ..
284 .deHP
285 .sp\\n(PDu
286 .ne1.1v
287 .if!\\$1 .nr )I \\$1n
288 .ll\\n(LLu
289 .in\\n()Ru+\\n(INu+\\n()Iu
290 .ti\\n()Ru+\\n(INu
291 .}f
292 ..
293 .deIP
294 .ie!\\$1 \{.TP "\\$2"
295 \&\\$1\}
296 .el\{.sp\\n(PDu
297 .ne1.1v
298 .if!\\$2 .nr )I \\$2n
299 .}f
300 .ll\\n(LLu
301 .in\\n()Ru+\\n(INu+\\n()Iu
302 .lg\}
303 ..
304 .deTP
305 .if!\\$1 \{.nr )I \\$1n
306 .if\\$10 .nr )I \\n()M\}
307 .sp\\n(PDu
308 .ne1.1v
309 .in\\n()Ru
310 .lg0
311 .ns
312 .it1 }N
313 .nr)E 1
314 .di]B
315 ..
316 .deTF
317 .IP "" "\w'\f5\\$1\ \ \fP'u"
318 .PD0
319 ..
320 .de}1
321 .ds]X \&\\*(]B\\
322 .rm]B
323 .nr)E 0
324 .if!\\$1 .nr )I \\$1n
325 .}f
326 .ll\\n(LLu
327 .in\\n()Ru+\\n(INu+\\n()Iu
328 .ti\\n(INu
329 .ie!\\n()Iu+\\n()Ru-\w\\*(]Xu-3p \{\\*(]X
330 .br\}
331 .el\\*(]X\h|\\n()Iu+\\n()Ru\c
332 .}f
333 .lg
334 ..
335 .de}N
336 .if\\n()E .br
337 .if\\n()E1 .di
338 .if\\n()E0 .}f
339 .if\\n()E1 .}1
340 .if\\n()E2 .}2
341 ..
342 .deRS
343 .nr]\\n+()p \\n()I
344 .nr)\\n()p \\n()R
345 .ie!\\$1 .nr )R +\\$1n
346 .el.nr )R +\\n()I
347 .nr)I \\n()Mu
348 .}E
349 ..
350 .deRE
351 .if!\\$1 \{.ie \\$10 .nr )p 1 1
352 .el.nr )p \\$1 1 \}
353 .ds]i \\*(]I\\n()p
354 .ds]r \\*(]R\\n()p
355 .nr)I \\*(]i
356 .nr)R \\*(]r
357 .if\\n()p .nr )p -1
358 .}E
359 ..
360 '''\" .2C begin 2-column display, by diversion
361 '''\" CC=amount of text that will fit on page
362 '''\" CL=1 multicolumn in effect, else 0
363 '''\" CI saved indent
364 '''\" CB contains diverted text
365 .de 2C
366 .ne 2
367 .nf
368 .nr CC \\n(.t/1v*2v
369 .nr CI \\n(IN
370 .nr IN 0
371 .di CB
372 .nr CL 1
373 .}E
374 .dt \\n(CCu C1
375 ..
376 '''\" .1C return to 1-column
377 .de 1C
378 .nr CL 0
379 .C1
380 .fi
381 ..
382 '''\" end of diversion, at end of page or return to 1-column
383 '''\" CC=pos of nominal column end
384 .de C1
385 .dt
386 \!.C3
387 .di
388 .if \\n(dn \{.nr CC \\n(dnu/2u+\\n(nlu
389 .wh \\n(CCu C2
390 .mk
391 .nf
392 .nr IN \\n(CIu
393 .}E
394 .CB \}
395 ..
396 '''\" end of first column retrieved from diversion
397 '''\" CC=pos of actual column end
398 .de C2
399 .wh \\n(CCu
400 .mk CC
401 .po +(\\n(LLu/2u)u
402 .rt
403 .if \\n(dn>1v .ns
404 ..
405 '''\" end of second column
406 .de C3
407 .br
408 .po -(\\n(LLu/2u)u
409 .if \\n(CC>\\n(nl .sp |\\n(CCu
410 .ne 2
411 ..
412 .dePM
413 .if\\$1 .nr !K 0
414 .if\w\\$1 \{\
415 .ie\\$1P .nr !K 1
416 .el.ie \\$1BP .nr !K 3
417 .el.ie \\$1BR .nr !K 4
418 .el.nr !K 2 \}
419 .if\\n(!K .wh -(\\n(:mu+5v) )G
420 ..
421 .de)G
422 .if\\n(!K 'sp 2v
423 .ie\\n(!K=1 \{\
424 .iet .bd1 3
425 .el.bd1 0
426 .tlPRIVATE
427 .bd1
428 .tlThis information should not be disclosed to unauthorized persons.
429 .tlIt is meant solely for use by authorized Bell System employees. \}
430 .el.ie \\n(!K=3 \{\
431 .iet .bd1 3
432 .el.bd1 0
433 .tlBELL LABORATORIES PROPRIETARY
434 .bd1
435 .tlNot for use or disclosure outside Bell Laboratories except by
436 .tlwritten approval of the director of the distributing organization. \}
437 .el.ie \\n(!K=4 \{\
438 .iet .bd1 3
439 .el.bd1 0
440 .tlBELL LABORATORIES RESTRICTED
441 .bd1
442 .tlThe information herein is meant solely for use by authorized
443 .tlBell Laboratories employees and is not to be disclosed to others. \}
444 .el.if \\n(!K=2 \{\
445 .iet .bd1 3
446 .el.bd1 0
447 .tlNOTICE
448 .bd1
449 .tlNot for use or disclosure outside the
450 .tlBell System except under written agreement. \}
451 ..
452 .nr)s 0
453 .ift .if \ns .nr )s 1
454 .nr)t 0
455 .ift .if !\ns .nr )t 1
456 .if\n()s \{.nr )L 9i
457 .nrLL 4.75i
458 .nr)O .75i
459 .nr)S 8
460 .nr)V 9 \}
461 .if\n()t \{.nr )L 11i
462 .nrLL 6.5i
463 .nr)O 1i
464 .nr)S 9
465 .nr)V 11 \}
466 .ift \{.ds R ®
467 .dsS \s\n()S
468 ..\}
469 .ifn \{.nr )L 11i
470 .nrLL 6.5i
471 .nr)O .463i
472 .if '\*(.T'think' \{.nrLL 80n
473 .nr)O 0\}
474 .if '\*(.T'thinksmall' \{.nrLL 142n
475 .vs 9p
476 .nr)O 0\}
477 .dsR (Reg.)
478 .dsS
479 ..\}
480 .if\nT .nr LL 80n
481 .if\nV>1 \{
482 .nrLL 82n
483 .nr)L 84v
484 .rmul \}
485 .nr)p 0 1
486 .ds]I \\\\n(]
487 .ds]R \\\\n()
488 .if\nd0 .nr m \n(mo-1
489 .if\nm0 .ds ]m January
490 .if\nm1 .ds ]m February
491 .if\nm2 .ds ]m March
492 .if\nm3 .ds ]m April
493 .if\nm4 .ds ]m May
494 .if\nm5 .ds ]m June
495 .if\nm6 .ds ]m July
496 .if\nm7 .ds ]m August
497 .if\nm8 .ds ]m September
498 .if\nm9 .ds ]m October
499 .if\nm10 .ds ]m November
500 .if\nm11 .ds ]m December
501 .ifn \{.nr m \nm+1
502 .nr yD (\n(yr%100
503 .af yD 01
504 .ie\nd .ds ]W (last mod. \nm/\nd/\ny)
505 .el.ds ]W (printed \n(mo/\n(dy/\n(yD)
506 ..\}
507 .if\n()s .ds ]W
508 .if\n()t \{.ie \nd .ds ]W \*(]m \nd, 20\ny
509 .el.ds ]W \*(]m \n(dy, 20\n(yr
510 ..\}
511 .pl\n()Lu
512 .ll\n(LLu
513 .lt\n(LLu
514 .po\n()Ou
515 .ift .tr \``\''
516 .}f
517 .if\n()s .nr :m 3.5v
518 .if\n()t .nr :m 6v
519 .ifn .nr :m 7v
520 .ift .nr )M 3.6m
521 .ifn .nr )M 5n
522 .em}K
523 .nr q \np
524 .if!\np .nr p 1
525 .pn \np