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 .de th
17 .tm wrong version of man entry macros - use -man6
18 .ab 
19 ..
20 .if n .ds Tm \uTM\d
21 .if t .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 .de DT
30 .if t .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 .if n .ta 5n 10n 15n 20n 25n 30n 35n 40n 45n 50n 55n 60n 65n
32 ..
33 .de HY
34 .hy 14
35 ..
36 .de }f
37 .if t .vs \\n()Vp
38 .ps \\n()S
39 .ft 1
40 ..
41 .de }H
42 .ev 1
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 .ft 1
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 .ev 1
59 .}E
60 .if \\n()s 'sp |\\n(.pu-1v-1p
61 .if \\n()t 'sp |\\n(.pu-3v
62 .if n 'sp |\\n(.pu-4v
63 .if n .tl Page %\\*(]D\\*(]W
64 .if t .tl %
65 .ev
66 'bp
67 ..
68 .if n .ig
69 .de }C
70 .if "\\*(.T"aps"\{\
71 . p o0i
72 . l t7.5i
73 . i f\\n()s .tl \l0.25i\l0.25i\h1i\l0.25i
74 . i f\\n()t .tl \l0.25i\l0.25i
75 . l t
76 . p o\}
77 ..
78 .de }M
79 .}N
80 .wh -.5p }C
81 .ll \\n(LLu
82 .}P
83 ..
84 .de }K
85 .}N
86 .pl 1
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 .de TH
96 .PD
97 .nr IN \\n()Mu
98 .if t .ds ]H \\$1\^(\^\\$2\^)
99 .if n .ds ]H \\$1(\\$2)
100 .if \\n()s .ds ]D
101 .if \\n()t .ds ]D Plan 9
102 .if n .ds ]D Plan 9
103 .ds ]L
104 .if !\\$3 .ds ]L (\^\\$3\^)
105 .if !\\$4 .ds ]D \\$4
106 .wh 0 }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 .if n \{.na
115 .nh \}
116 .if t \{.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 .de SH
128 .PD
129 .}X 0 "\\$1"
130 .nr )E 2
131 \&\Xhtml <H4>\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\Xhtml </H4>
132 ..
133 .de SS
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 .ne 1.1v
144 .nr )R 0
145 .fi
146 '''ss12
147 '''if\\$2SYNOPSIS .ss 18
148 .it 1 }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 .ft 1
158 ..
159 .de SM
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 .de I
173 .nh
174 .ft 2
175 .it 1 }N
176 .if !\\$1 \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
177 .HY
178 ..
179 .de B
180 .nh
181 .it 1 }N
182 .ie !\\$1 \%\&\f5\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
183 .el .ft5
184 .HY
185 ..
186 .de L
187 .nh
188 .it 1 }N
189 .if t \{.ie!\\$1 \%\&\f5\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
190 .el .ft5 \}
191 .if n \{.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 .de RI
201 .nh
202 .}S 1 2 \& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
203 .HY
204 .}f
205 ..
206 .de IR
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 .de IB
213 .nh
214 .if t .}S 2 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
215 .if n .}S 2 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
216 .HY
217 .}f
218 ..
219 .de RB
220 .nh
221 .if t .}S 1 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
222 .if n .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
223 .HY
224 .}f
225 ..
226 .de BR
227 .nh
228 .if t .}S 5 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
229 .if n .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
230 .HY
231 .}f
232 ..
233 .de BI
234 .nh
235 .if t .}S 5 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
236 .if n .}S 1 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
237 .HY
238 .}f
239 ..
240 .de LR
241 .nh
242 .if t \%\&\f5\\$1\f1\\$2
243 .if n \%`\\$1'\\$2
244 .HY
245 ..
246 .de RL
247 .nh
248 .if t \%\&\f1\\$1\\f5\\$2\\f1\\$3
249 .if n \%\\$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 .de EX
261 .if t .ft5
262 .nf
263 ..
264 .de EE
265 .ft 1
266 .fi
267 ..
268 .de }p
269 .sp \\n(PDu
270 .ne 1.1v
271 .}E
272 .nr )I \\n()Mu
273 .ns
274 ..
275 .de PP \"indirect PP so we can attach html - see tmac.anhtml
276 .}p
277 ..
278 .de P
279 .PP
280 ..
281 .de LP
282 .PP
283 ..
284 .de PD
285 .if t .nr PD .4v
286 .if n .nr PD 1v
287 .if !\\$1 .nr PD \\$1v
288 ..
289 .de HP
290 .sp \\n(PDu
291 .ne 1.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 .de IP
299 .ie !\\$1 \{.TP "\\$2"
300 \&\\$1\}
301 .el \{.sp\\n(PDu
302 .ne 1.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 .de TP
310 .if !\\$1 \{.nr )I \\$1n
311 .if \\$10 .nr )I \\n()M\}
312 .sp \\n(PDu
313 .ne 1.1v
314 .in \\n()Ru
315 .lg 0
316 .ns
317 .it 1 }N
318 .nr )E 1
319 .di ]B
320 ..
321 .de TF
322 .IP "" "\w'\f5\\$1\ \ \fP'u"
323 .PD 0
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 .de RS
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 .de RE
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 .de PM
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 .ie t .bd1 3
430 .el .bd1 0
431 .tl PRIVATE
432 .bd 1
433 .tl This information should not be disclosed to unauthorized persons.
434 .tl It is meant solely for use by authorized Bell System employees. \}
435 .el .ie \\n(!K=3 \{\
436 .ie t .bd1 3
437 .el .bd1 0
438 .tl BELL LABORATORIES PROPRIETARY
439 .bd 1
440 .tl Not for use or disclosure outside Bell Laboratories except by
441 .tl written approval of the director of the distributing organization. \}
442 .el .ie \\n(!K=4 \{\
443 .ie t .bd1 3
444 .el .bd1 0
445 .tl BELL LABORATORIES RESTRICTED
446 .bd 1
447 .tl The information herein is meant solely for use by authorized
448 .tl Bell Laboratories employees and is not to be disclosed to others. \}
449 .el .if \\n(!K=2 \{\
450 .ie t .bd1 3
451 .el .bd1 0
452 .tl NOTICE
453 .bd 1
454 .tl Not for use or disclosure outside the
455 .tl Bell System except under written agreement. \}
456 ..
457 .nr )s 0
458 .if t .if \ns .nr )s 1
459 .nr )t 0
460 .if t .if !\ns .nr )t 1
461 .if \n()s \{.nr )L 9i
462 .nr LL 4.75i
463 .nr )O .75i
464 .nr )S 8
465 .nr )V 9 \}
466 .if \n()t \{.nr )L 11i
467 .nr LL 6.5i
468 .nr )O 1i
469 .nr )S 9
470 .nr )V 11 \}
471 .if t \{.ds R ®
472 .ds S \s\n()S
473 ..\}
474 .if n \{.nr )L 11i
475 .nr LL 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 .ds R (Reg.)
483 .ds S
484 ..\}
485 .if \nT .nr LL 80n
486 .if \nV>1 \{
487 .nr LL 82n
488 .nr )L 84v
489 .rm ul \}
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 .if n \{.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 .if t .tr \``\''
521 .}f
522 .if \n()s .nr :m 3.5v
523 .if \n()t .nr :m 6v
524 .if n .nr :m 7v
525 .if t .nr )M 3.6m
526 .if n .nr )M 5n
527 .em }K
528 .nr q \np
529 .if !\np .nr p 1
530 .pn \np