Blob
1 .fp 1 R LuxiSans2 .fp 2 I LuxiSans-Oblique3 .fp 3 B LuxiSans-Bold4 .fp 4 BI LuxiSans-BoldOblique5 .fp 5 L LuxiMono6 .ds 9 /usr/local/plan97 .if n .uf 48 .if n .bd 39 .if n .rm bd10 '''\" PWB Manual Entry Macros - 1.36 of 11/11/8011 '''\" Nroff/Troff Version @(#)1.3612 '''\" Option -rs1 short (9") pages13 '''\" Option -rp# set no. of first page, put no. of pgs. on stderr14 '''\" Option -rd1 give modified date instead of printed date15 ... temporary fixes for neat manual printing...16 .de th17 .tm wrong version of man entry macros - use -man618 .ab19 ..20 .if n .ds Tm \uTM\d21 .if t .ds Tm \v'-0.5m'\s-4TM\s+4\v'0.5m'22 .de }E23 .}f24 .in \\n()Ru+\\n(INu25 .ll \\n(LLu26 .lt \\n(LLu27 .pl \\n()Lu28 ..29 .de DT30 .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.8m31 .if n .ta 5n 10n 15n 20n 25n 30n 35n 40n 45n 50n 55n 60n 65n32 ..33 .de HY34 .hy 1435 ..36 .de }f37 .if t .vs \\n()Vp38 .ps \\n()S39 .ft 140 ..41 .de }H42 .ev 143 .}C44 .}E45 .ie \\n()s 'sp |2v46 .el 'sp |3v47 .". ps\\n()S-148 .tl \\*(]H\\*(]L\\*(]H49 .ft 150 .ps \\n()S51 .ie \\n()s 'sp 1.5v52 .el 'sp 3v53 .ev54 .ns55 .if \\n(CL .2C56 ..57 .de }F58 .ev 159 .}E60 .if \\n()s 'sp |\\n(.pu-1v-1p61 .if \\n()t 'sp |\\n(.pu-3v62 .if n 'sp |\\n(.pu-4v63 .if n .tl Page %\\*(]D\\*(]W64 .if t .tl %65 .ev66 'bp67 ..68 .if n .ig69 .de }C70 .if "\\*(.T"aps"\{\71 . p o0i72 . l t7.5i73 . i f\\n()s .tl \l0.25i\l0.25i\h1i\l0.25i74 . i f\\n()t .tl \l0.25i\l0.25i75 . l t76 . p o\}77 ..78 .de }M79 .}N80 .wh -.5p }C81 .ll \\n(LLu82 .}P83 ..84 .de }K85 .}N86 .pl 187 .ll \\n(LLu88 ..89 .de }P90 .nr )P \\n%+1-\\np91 .if \\nq .tm \\n(.F \\n()P \\np92 .bp93 .if \\nq .nr p \\n%94 ..95 .de TH96 .PD97 .nr IN \\n()Mu98 .if t .ds ]H \\$1\^(\^\\$2\^)99 .if n .ds ]H \\$1(\\$2)100 .if \\n()s .ds ]D101 .if \\n()t .ds ]D Plan 9102 .if n .ds ]D Plan 9103 .ds ]L104 .if !\\$3 .ds ]L (\^\\$3\^)105 .if !\\$4 .ds ]D \\$4106 .wh 0 }H107 .wh -\\n(:mu }F108 .em }M109 .if \\n(nl .}P110 .nr )I \\n()Mu111 .nr )R 0112 .}E113 .DT114 .if n \{.na115 .nh \}116 .if t \{.bd S 3 3117 .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 HR124 .ie '\\$2'' \\$4\X'html href \\$1'\fL\\$1\fP\X'html /href'\\$3125 .el \\$4\X'html href \\$1'\\$2\X'html /href'\\$3126 ..127 .de SH128 .PD129 .}X 0 "\\$1"130 .nr )E 2131 \&\Xhtml <H4>\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\Xhtml </H4>132 ..133 .de SS134 .PD135 .}X 3n "" ""136 .nr )E 2137 \Xhtml <H4>\&\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\Xhtml </H4>138 ..139 .de }X140 .}E141 .ti \\$1142 .sp \\n(PDu143 .ne 1.1v144 .nr )R 0145 .fi146 '''ss12147 '''if\\$2SYNOPSIS .ss 18148 .it 1 }N149 .if !\\$3 .SM150 .ft 3151 ..152 .de }2153 .nr )E 0154 .}E155 .nr )I \\n()Mu156 .ns157 .ft 1158 ..159 .de SM160 .nh161 .ps \\n()S-1162 .if !\\$1 \&\\$1163 .if !\\$2 \&\\$2164 .if !\\$3 \&\\$3165 .if !\\$4 \&\\$4166 .if !\\$5 \&\\$5167 .if !\\$6 \&\\$6168 .if !\\$1 .ps \\n()S169 .if \\$1 .it 1 }N170 .HY171 ..172 .de I173 .nh174 .ft 2175 .it 1 }N176 .if !\\$1 \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6177 .HY178 ..179 .de B180 .nh181 .it 1 }N182 .ie !\\$1 \%\&\f5\\$1 \\$2 \\$3 \\$4 \\$5 \\$6183 .el .ft5184 .HY185 ..186 .de L187 .nh188 .it 1 }N189 .if t \{.ie!\\$1 \%\&\f5\\$1 \\$2 \\$3 \\$4 \\$5 \\$6190 .el .ft5 \}191 .if n \{.ft5192 .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 .HY199 ..200 .de RI201 .nh202 .}S 1 2 \& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"203 .HY204 .}f205 ..206 .de IR207 .nh208 .}S 2 1 \& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"209 .HY210 .}f211 ..212 .\" MR - manual reference, as in .MR cat (1) ,213 .\" $3 is the punctuation after the reference ends, if any.214 .de MR215 .nh216 .}S 2 1 \& "\Xhtml manref start \\$1 \\$2\\$1" "\\$2\Xhtml manref end \\$1 \\$2\\$3"217 .HY218 .}f219 ..220 .de IB221 .nh222 .if t .}S 2 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"223 .if n .}S 2 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"224 .HY225 .}f226 ..227 .de RB228 .nh229 .if t .}S 1 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"230 .if n .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"231 .HY232 .}f233 ..234 .de BR235 .nh236 .if t .}S 5 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"237 .if n .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"238 .HY239 .}f240 ..241 .de BI242 .nh243 .if t .}S 5 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"244 .if n .}S 1 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"245 .HY246 .}f247 ..248 .de LR249 .nh250 .if t \%\&\f5\\$1\f1\\$2251 .if n \%`\\$1'\\$2252 .HY253 ..254 .de RL255 .nh256 .if t \%\&\f1\\$1\\f5\\$2\\f1\\$3257 .if n \%\\$1`\\$2'\\$3258 .HY259 ..260 .de }S261 .ds ]F262 .if \\$12 .if !\\$5 .ds ]F \^263 .if \\$22 .if !\\$5 .ds ]F \^264 .ie !\\$4 .}S \\$2 \\$1 "\\$3\f\\$1\\$4\\*(]F" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"265 .el \\$3266 .}f267 ..268 .de EX269 .if t .ft5270 .nf271 ..272 .de EE273 .ft 1274 .fi275 ..276 .de }p277 .sp \\n(PDu278 .ne 1.1v279 .}E280 .nr )I \\n()Mu281 .ns282 ..283 .de PP \"indirect PP so we can attach html - see tmac.anhtml284 .}p285 ..286 .de P287 .PP288 ..289 .de LP290 .PP291 ..292 .de PD293 .if t .nr PD .4v294 .if n .nr PD 1v295 .if !\\$1 .nr PD \\$1v296 ..297 .de HP298 .sp \\n(PDu299 .ne 1.1v300 .if !\\$1 .nr )I \\$1n301 .ll \\n(LLu302 .in \\n()Ru+\\n(INu+\\n()Iu303 .ti \\n()Ru+\\n(INu304 .}f305 ..306 .de IP307 .ie !\\$1 \{.TP "\\$2"308 \&\\$1\}309 .el \{.sp\\n(PDu310 .ne 1.1v311 .if !\\$2 .nr )I \\$2n312 .}f313 .ll \\n(LLu314 .in \\n()Ru+\\n(INu+\\n()Iu315 .lg \}316 ..317 .de TP318 .if !\\$1 \{.nr )I \\$1n319 .if \\$10 .nr )I \\n()M\}320 .sp \\n(PDu321 .ne 1.1v322 .in \\n()Ru323 .lg 0324 .ns325 .it 1 }N326 .nr )E 1327 .di ]B328 ..329 .de TF330 .IP "" "\w'\f5\\$1\ \ \fP'u"331 .PD 0332 ..333 .de }1334 .ds ]X \&\\*(]B\\335 .rm ]B336 .nr )E 0337 .if !\\$1 .nr )I \\$1n338 .}f339 .ll \\n(LLu340 .in \\n()Ru+\\n(INu+\\n()Iu341 .ti \\n(INu342 .ie !\\n()Iu+\\n()Ru-\w\\*(]Xu-3p \{\\*(]X343 .br \}344 .el \\*(]X\h|\\n()Iu+\\n()Ru\c345 .}f346 .lg347 ..348 .de }N349 .if \\n()E .br350 .if \\n()E1 .di351 .if \\n()E0 .}f352 .if \\n()E1 .}1353 .if \\n()E2 .}2354 ..355 .de RS356 .nr ]\\n+()p \\n()I357 .nr )\\n()p \\n()R358 .ie !\\$1 .nr )R +\\$1n359 .el .nr )R +\\n()I360 .nr )I \\n()Mu361 .}E362 ..363 .de RE364 .if !\\$1 \{.ie \\$10 .nr )p 1 1365 .el .nr )p \\$1 1 \}366 .ds ]i \\*(]I\\n()p367 .ds ]r \\*(]R\\n()p368 .nr )I \\*(]i369 .nr )R \\*(]r370 .if \\n()p .nr )p -1371 .}E372 ..373 '''\" .2C begin 2-column display, by diversion374 '''\" CC=amount of text that will fit on page375 '''\" CL=1 multicolumn in effect, else 0376 '''\" CI saved indent377 '''\" CB contains diverted text378 .de 2C379 .ne 2380 .nf381 .nr CC \\n(.t/1v*2v382 .nr CI \\n(IN383 .nr IN 0384 .di CB385 .nr CL 1386 .}E387 .dt \\n(CCu C1388 ..389 '''\" .1C return to 1-column390 .de 1C391 .nr CL 0392 .C1393 .fi394 ..395 '''\" end of diversion, at end of page or return to 1-column396 '''\" CC=pos of nominal column end397 .de C1398 .dt399 \!.C3400 .di401 .if \\n(dn \{.nr CC \\n(dnu/2u+\\n(nlu402 .wh \\n(CCu C2403 .mk404 .nf405 .nr IN \\n(CIu406 .}E407 .CB \}408 ..409 '''\" end of first column retrieved from diversion410 '''\" CC=pos of actual column end411 .de C2412 .wh \\n(CCu413 .mk CC414 .po +(\\n(LLu/2u)u415 .rt416 .if \\n(dn>1v .ns417 ..418 '''\" end of second column419 .de C3420 .br421 .po -(\\n(LLu/2u)u422 .if \\n(CC>\\n(nl .sp |\\n(CCu423 .ne 2424 ..425 .de PM426 .if \\$1 .nr !K 0427 .if \w\\$1 \{\428 .ie \\$1P .nr !K 1429 .el .ie \\$1BP .nr !K 3430 .el .ie \\$1BR .nr !K 4431 .el .nr !K 2 \}432 .if \\n(!K .wh -(\\n(:mu+5v) )G433 ..434 .de )G435 .if \\n(!K 'sp 2v436 .ie \\n(!K=1 \{\437 .ie t .bd1 3438 .el .bd1 0439 .tl PRIVATE440 .bd 1441 .tl This information should not be disclosed to unauthorized persons.442 .tl It is meant solely for use by authorized Bell System employees. \}443 .el .ie \\n(!K=3 \{\444 .ie t .bd1 3445 .el .bd1 0446 .tl BELL LABORATORIES PROPRIETARY447 .bd 1448 .tl Not for use or disclosure outside Bell Laboratories except by449 .tl written approval of the director of the distributing organization. \}450 .el .ie \\n(!K=4 \{\451 .ie t .bd1 3452 .el .bd1 0453 .tl BELL LABORATORIES RESTRICTED454 .bd 1455 .tl The information herein is meant solely for use by authorized456 .tl Bell Laboratories employees and is not to be disclosed to others. \}457 .el .if \\n(!K=2 \{\458 .ie t .bd1 3459 .el .bd1 0460 .tl NOTICE461 .bd 1462 .tl Not for use or disclosure outside the463 .tl Bell System except under written agreement. \}464 ..465 .nr )s 0466 .if t .if \ns .nr )s 1467 .nr )t 0468 .if t .if !\ns .nr )t 1469 .if \n()s \{.nr )L 9i470 .nr LL 4.75i471 .nr )O .75i472 .nr )S 8473 .nr )V 9 \}474 .if \n()t \{.nr )L 11i475 .nr LL 6.5i476 .nr )O 1i477 .nr )S 9478 .nr )V 11 \}479 .if t \{.ds R ®480 .ds S \s\n()S481 ..\}482 .if n \{.nr )L 11i483 .nr LL 6.5i484 .nr )O .463i485 .if '\*(.T'think' \{.nrLL 80n486 .nr )O 0\}487 .if '\*(.T'thinksmall' \{.nrLL 142n488 .vs 9p489 .nr )O 0\}490 .ds R (Reg.)491 .ds S492 ..\}493 .if \nT .nr LL 80n494 .if \nV>1 \{495 .nr LL 82n496 .nr )L 84v497 .rm ul \}498 .nr )p 0 1499 .ds ]I \\\\n(]500 .ds ]R \\\\n()501 .if \nd0 .nr m \n(mo-1502 .if \nm0 .ds ]m January503 .if \nm1 .ds ]m February504 .if \nm2 .ds ]m March505 .if \nm3 .ds ]m April506 .if \nm4 .ds ]m May507 .if \nm5 .ds ]m June508 .if \nm6 .ds ]m July509 .if \nm7 .ds ]m August510 .if \nm8 .ds ]m September511 .if \nm9 .ds ]m October512 .if \nm10 .ds ]m November513 .if \nm11 .ds ]m December514 .if n \{.nr m \nm+1515 .nr yD (\n(yr%100516 .af yD 01517 .ie \nd .ds ]W (last mod. \nm/\nd/\ny)518 .el .ds ]W (printed \n(mo/\n(dy/\n(yD)519 ..\}520 .if \n()s .ds ]W521 .if \n()t \{.ie \nd .ds ]W \*(]m \nd, 20\ny522 .el .ds ]W \*(]m \n(dy, 20\n(yr523 ..\}524 .pl \n()Lu525 .ll \n(LLu526 .lt \n(LLu527 .po \n()Ou528 .if t .tr \``\''529 .}f530 .if \n()s .nr :m 3.5v531 .if \n()t .nr :m 6v532 .if n .nr :m 7v533 .if t .nr )M 3.6m534 .if n .nr )M 5n535 .em }K536 .nr q \np537 .if !\np .nr p 1538 .pn \np