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 \& "\Xhtml manref start \\$1 \\$2\\$1" "\\$2\Xhtml manref end \\$1 \\$2" "\\$3" "\\$4" "\\$5" "\\$6"209 .HY210 .}f211 ..212 .de IB213 .nh214 .if t .}S 2 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"215 .if n .}S 2 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"216 .HY217 .}f218 ..219 .de RB220 .nh221 .if t .}S 1 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"222 .if n .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"223 .HY224 .}f225 ..226 .de BR227 .nh228 .if t .}S 5 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"229 .if n .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"230 .HY231 .}f232 ..233 .de BI234 .nh235 .if t .}S 5 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"236 .if n .}S 1 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"237 .HY238 .}f239 ..240 .de LR241 .nh242 .if t \%\&\f5\\$1\f1\\$2243 .if n \%`\\$1'\\$2244 .HY245 ..246 .de RL247 .nh248 .if t \%\&\f1\\$1\\f5\\$2\\f1\\$3249 .if n \%\\$1`\\$2'\\$3250 .HY251 ..252 .de }S253 .ds ]F254 .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 \\$3258 .}f259 ..260 .de EX261 .if t .ft5262 .nf263 ..264 .de EE265 .ft 1266 .fi267 ..268 .de }p269 .sp \\n(PDu270 .ne 1.1v271 .}E272 .nr )I \\n()Mu273 .ns274 ..275 .de PP \"indirect PP so we can attach html - see tmac.anhtml276 .}p277 ..278 .de P279 .PP280 ..281 .de LP282 .PP283 ..284 .de PD285 .if t .nr PD .4v286 .if n .nr PD 1v287 .if !\\$1 .nr PD \\$1v288 ..289 .de HP290 .sp \\n(PDu291 .ne 1.1v292 .if !\\$1 .nr )I \\$1n293 .ll \\n(LLu294 .in \\n()Ru+\\n(INu+\\n()Iu295 .ti \\n()Ru+\\n(INu296 .}f297 ..298 .de IP299 .ie !\\$1 \{.TP "\\$2"300 \&\\$1\}301 .el \{.sp\\n(PDu302 .ne 1.1v303 .if !\\$2 .nr )I \\$2n304 .}f305 .ll \\n(LLu306 .in \\n()Ru+\\n(INu+\\n()Iu307 .lg \}308 ..309 .de TP310 .if !\\$1 \{.nr )I \\$1n311 .if \\$10 .nr )I \\n()M\}312 .sp \\n(PDu313 .ne 1.1v314 .in \\n()Ru315 .lg 0316 .ns317 .it 1 }N318 .nr )E 1319 .di ]B320 ..321 .de TF322 .IP "" "\w'\f5\\$1\ \ \fP'u"323 .PD 0324 ..325 .de }1326 .ds ]X \&\\*(]B\\327 .rm ]B328 .nr )E 0329 .if !\\$1 .nr )I \\$1n330 .}f331 .ll \\n(LLu332 .in \\n()Ru+\\n(INu+\\n()Iu333 .ti \\n(INu334 .ie !\\n()Iu+\\n()Ru-\w\\*(]Xu-3p \{\\*(]X335 .br \}336 .el \\*(]X\h|\\n()Iu+\\n()Ru\c337 .}f338 .lg339 ..340 .de }N341 .if \\n()E .br342 .if \\n()E1 .di343 .if \\n()E0 .}f344 .if \\n()E1 .}1345 .if \\n()E2 .}2346 ..347 .de RS348 .nr ]\\n+()p \\n()I349 .nr )\\n()p \\n()R350 .ie !\\$1 .nr )R +\\$1n351 .el .nr )R +\\n()I352 .nr )I \\n()Mu353 .}E354 ..355 .de RE356 .if !\\$1 \{.ie \\$10 .nr )p 1 1357 .el .nr )p \\$1 1 \}358 .ds ]i \\*(]I\\n()p359 .ds ]r \\*(]R\\n()p360 .nr )I \\*(]i361 .nr )R \\*(]r362 .if \\n()p .nr )p -1363 .}E364 ..365 '''\" .2C begin 2-column display, by diversion366 '''\" CC=amount of text that will fit on page367 '''\" CL=1 multicolumn in effect, else 0368 '''\" CI saved indent369 '''\" CB contains diverted text370 .de 2C371 .ne 2372 .nf373 .nr CC \\n(.t/1v*2v374 .nr CI \\n(IN375 .nr IN 0376 .di CB377 .nr CL 1378 .}E379 .dt \\n(CCu C1380 ..381 '''\" .1C return to 1-column382 .de 1C383 .nr CL 0384 .C1385 .fi386 ..387 '''\" end of diversion, at end of page or return to 1-column388 '''\" CC=pos of nominal column end389 .de C1390 .dt391 \!.C3392 .di393 .if \\n(dn \{.nr CC \\n(dnu/2u+\\n(nlu394 .wh \\n(CCu C2395 .mk396 .nf397 .nr IN \\n(CIu398 .}E399 .CB \}400 ..401 '''\" end of first column retrieved from diversion402 '''\" CC=pos of actual column end403 .de C2404 .wh \\n(CCu405 .mk CC406 .po +(\\n(LLu/2u)u407 .rt408 .if \\n(dn>1v .ns409 ..410 '''\" end of second column411 .de C3412 .br413 .po -(\\n(LLu/2u)u414 .if \\n(CC>\\n(nl .sp |\\n(CCu415 .ne 2416 ..417 .de PM418 .if \\$1 .nr !K 0419 .if \w\\$1 \{\420 .ie \\$1P .nr !K 1421 .el .ie \\$1BP .nr !K 3422 .el .ie \\$1BR .nr !K 4423 .el .nr !K 2 \}424 .if \\n(!K .wh -(\\n(:mu+5v) )G425 ..426 .de )G427 .if \\n(!K 'sp 2v428 .ie \\n(!K=1 \{\429 .ie t .bd1 3430 .el .bd1 0431 .tl PRIVATE432 .bd 1433 .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 3437 .el .bd1 0438 .tl BELL LABORATORIES PROPRIETARY439 .bd 1440 .tl Not for use or disclosure outside Bell Laboratories except by441 .tl written approval of the director of the distributing organization. \}442 .el .ie \\n(!K=4 \{\443 .ie t .bd1 3444 .el .bd1 0445 .tl BELL LABORATORIES RESTRICTED446 .bd 1447 .tl The information herein is meant solely for use by authorized448 .tl Bell Laboratories employees and is not to be disclosed to others. \}449 .el .if \\n(!K=2 \{\450 .ie t .bd1 3451 .el .bd1 0452 .tl NOTICE453 .bd 1454 .tl Not for use or disclosure outside the455 .tl Bell System except under written agreement. \}456 ..457 .nr )s 0458 .if t .if \ns .nr )s 1459 .nr )t 0460 .if t .if !\ns .nr )t 1461 .if \n()s \{.nr )L 9i462 .nr LL 4.75i463 .nr )O .75i464 .nr )S 8465 .nr )V 9 \}466 .if \n()t \{.nr )L 11i467 .nr LL 6.5i468 .nr )O 1i469 .nr )S 9470 .nr )V 11 \}471 .if t \{.ds R ®472 .ds S \s\n()S473 ..\}474 .if n \{.nr )L 11i475 .nr LL 6.5i476 .nr )O .463i477 .if '\*(.T'think' \{.nrLL 80n478 .nr )O 0\}479 .if '\*(.T'thinksmall' \{.nrLL 142n480 .vs 9p481 .nr )O 0\}482 .ds R (Reg.)483 .ds S484 ..\}485 .if \nT .nr LL 80n486 .if \nV>1 \{487 .nr LL 82n488 .nr )L 84v489 .rm ul \}490 .nr )p 0 1491 .ds ]I \\\\n(]492 .ds ]R \\\\n()493 .if \nd0 .nr m \n(mo-1494 .if \nm0 .ds ]m January495 .if \nm1 .ds ]m February496 .if \nm2 .ds ]m March497 .if \nm3 .ds ]m April498 .if \nm4 .ds ]m May499 .if \nm5 .ds ]m June500 .if \nm6 .ds ]m July501 .if \nm7 .ds ]m August502 .if \nm8 .ds ]m September503 .if \nm9 .ds ]m October504 .if \nm10 .ds ]m November505 .if \nm11 .ds ]m December506 .if n \{.nr m \nm+1507 .nr yD (\n(yr%100508 .af yD 01509 .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 ]W513 .if \n()t \{.ie \nd .ds ]W \*(]m \nd, 20\ny514 .el .ds ]W \*(]m \n(dy, 20\n(yr515 ..\}516 .pl \n()Lu517 .ll \n(LLu518 .lt \n(LLu519 .po \n()Ou520 .if t .tr \``\''521 .}f522 .if \n()s .nr :m 3.5v523 .if \n()t .nr :m 6v524 .if n .nr :m 7v525 .if t .nr )M 3.6m526 .if n .nr )M 5n527 .em }K528 .nr q \np529 .if !\np .nr p 1530 .pn \np