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