Blob
1 .fp 1 R LucidaSans2 .fp 2 I LucidaSansI3 .fp 3 B LucidaSansB4 .fp 5 L LucidaCW5 .if n .uf 46 .if n .bd 37 .if n .rm bd8 '''\" PWB Manual Entry Macros - 1.36 of 11/11/809 '''\" Nroff/Troff Version @(#)1.3610 '''\" Option -rs1 short (9") pages11 '''\" Option -rp# set no. of first page, put no. of pgs. on stderr12 '''\" Option -rd1 give modified date instead of printed date13 ... temporary fixes for neat manual printing...14 .deth15 .tmwrong version of man entry macros - use -man616 .ab17 ..18 .ifn .ds Tm \uTM\d19 .ift .ds Tm \v'-0.5m'\s-4TM\s+4\v'0.5m'20 .de}E21 .}f22 .in\\n()Ru+\\n(INu23 .ll\\n(LLu24 .lt\\n(LLu25 .pl\\n()Lu26 ..27 .deDT28 .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.8m29 .ifn .ta 5n 10n 15n 20n 25n 30n 35n 40n 45n 50n 55n 60n 65n30 ..31 .de HY32 .hy1433 ..34 .de}f35 .ift .vs \\n()Vp36 .ps\\n()S37 .ft138 ..39 .de}H40 .ev141 .}C42 .}E43 .ie\\n()s 'sp |2v44 .el'sp |3v45 .".ps\\n()S-146 .tl \\*(]H\\*(]L\\*(]H47 .ft148 .ps\\n()S49 .ie\\n()s 'sp 1.5v50 .el'sp 3v51 .ev52 .ns53 .if \\n(CL .2C54 ..55 .de}F56 .ev157 .}E58 .if\\n()s 'sp |\\n(.pu-1v-1p59 .if\\n()t 'sp |\\n(.pu-3v60 .ifn 'sp |\\n(.pu-4v61 .ifn .tl Page %\\*(]D\\*(]W62 .ift .tl %63 .ev64 'bp65 ..66 .ifn .ig67 .de}C68 .if "\\*(.T"aps"\{\69 . po0i70 . lt7.5i71 . if\\n()s .tl \l0.25i\l0.25i\h1i\l0.25i72 . if\\n()t .tl \l0.25i\l0.25i73 . lt74 . po\}75 ..76 .de}M77 .}N78 .wh-.5p }C79 .ll\\n(LLu80 .}P81 ..82 .de}K83 .}N84 .pl185 .ll\\n(LLu86 ..87 .de}P88 .nr )P \\n%+1-\\np89 .if \\nq .tm \\n(.F \\n()P \\np90 .bp91 .if \\nq .nr p \\n%92 ..93 .deTH94 .PD95 .nrIN \\n()Mu96 .ift .ds ]H \\$1\^(\^\\$2\^)97 .ifn .ds ]H \\$1(\\$2)98 .if\\n()s .ds ]D99 .if\\n()t .ds ]D Plan 9100 .ifn .ds ]D Plan 9101 .ds]L102 .if!\\$3 .ds ]L (\^\\$3\^)103 .if!\\$4 .ds ]D \\$4104 .wh0 }H105 .wh-\\n(:mu }F106 .em}M107 .if\\n(nl .}P108 .nr)I \\n()Mu109 .nr)R 0110 .}E111 .DT112 .ifn \{.na113 .nh\}114 .ift \{.bd S 3 3115 .HY \}116 \Xhtml <B>117 \Xhtml [<A HREF="/sys/man/index.html">manual index</A>]118 \Xhtml [<A HREF="/sys/man/\\$2/INDEX.html">section index</A>]119 \Xhtml </B>120 ..121 .deSH122 .PD123 .}X 0 "\\$1"124 .nr)E 2125 \&\Xhtml <H4>\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\Xhtml </H4>126 ..127 .deSS128 .PD129 .}X 3n "" ""130 .nr)E 2131 \Xhtml <H4>\&\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6\Xhtml </H4>132 ..133 .de}X134 .}E135 .ti\\$1136 .sp\\n(PDu137 .ne1.1v138 .nr)R 0139 .fi140 '''ss12141 '''if\\$2SYNOPSIS .ss 18142 .it1 }N143 .if!\\$3 .SM144 .ft 3145 ..146 .de}2147 .nr)E 0148 .}E149 .nr)I \\n()Mu150 .ns151 .ft1152 ..153 .deSM154 .nh155 .ps\\n()S-1156 .if!\\$1 \&\\$1157 .if!\\$2 \&\\$2158 .if!\\$3 \&\\$3159 .if!\\$4 \&\\$4160 .if!\\$5 \&\\$5161 .if!\\$6 \&\\$6162 .if!\\$1 .ps \\n()S163 .if\\$1 .it 1 }N164 .HY165 ..166 .deI167 .nh168 .ft2169 .it1 }N170 .if!\\$1 \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6171 .HY172 ..173 .deB174 .nh175 .it1 }N176 .ie!\\$1 \%\&\f5\\$1 \\$2 \\$3 \\$4 \\$5 \\$6177 .el .ft5178 .HY179 ..180 .deL181 .nh182 .it1 }N183 .ift \{.ie!\\$1 \%\&\f5\\$1 \\$2 \\$3 \\$4 \\$5 \\$6184 .el .ft5 \}185 .ifn \{.ft5186 .if!\\$1 \{.ie\\$2 `\\$1'187 .el .ie\\$3 `\\$1 \\$2'188 .el .ie\\$4 `\\$1 \\$2 \\$3'189 .el .ie\\$5 `\\$1 \\$2 \\$3 \\$4'190 .el .ie\\$6 `\\$1 \\$2 \\$3 \\$4 \\$5'191 .el `\\$1 \\$2 \\$3 \\$4 \\$5 \\$6'\}\}192 .HY193 ..194 .deRI195 .nh196 .}S 1 2 \& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"197 .HY198 .}f199 ..200 .deIR201 .nh202 .}S 2 1 \& "\Xhtml manref start \\$1 \\$2\\$1" "\\$2\Xhtml manref end \\$1 \\$2" "\\$3" "\\$4" "\\$5" "\\$6"203 .HY204 .}f205 ..206 .deIB207 .nh208 .ift .}S 2 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"209 .ifn .}S 2 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"210 .HY211 .}f212 ..213 .deRB214 .nh215 .ift .}S 1 5 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"216 .ifn .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"217 .HY218 .}f219 ..220 .deBR221 .nh222 .ift .}S 5 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"223 .ifn .}S 1 1 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"224 .HY225 .}f226 ..227 .deBI228 .nh229 .ift .}S 5 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"230 .ifn .}S 1 2 \%\& "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"231 .HY232 .}f233 ..234 .de LR235 .nh236 .ift \%\&\f5\\$1\f1\\$2237 .ifn \%`\\$1'\\$2238 .HY239 ..240 .de RL241 .nh242 .ift \%\&\f1\\$1\\f5\\$2\\f1\\$3243 .ifn \%\\$1`\\$2'\\$3244 .HY245 ..246 .de}S247 .ds]F248 .if\\$12 .if !\\$5 .ds ]F \^249 .if\\$22 .if !\\$5 .ds ]F \^250 .ie!\\$4 .}S \\$2 \\$1 "\\$3\f\\$1\\$4\\*(]F" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"251 .el\\$3252 .}f253 ..254 .deEX255 .ift .ft5256 .nf257 ..258 .deEE259 .ft1260 .fi261 ..262 .de}p263 .sp\\n(PDu264 .ne1.1v265 .}E266 .nr)I \\n()Mu267 .ns268 ..269 .dePP \"indirect PP so we can attach html - see tmac.anhtml270 .}p271 ..272 .deP273 .PP274 ..275 .deLP276 .PP277 ..278 .dePD279 .ift .nr PD .4v280 .ifn .nr PD 1v281 .if!\\$1 .nr PD \\$1v282 ..283 .deHP284 .sp\\n(PDu285 .ne1.1v286 .if!\\$1 .nr )I \\$1n287 .ll\\n(LLu288 .in\\n()Ru+\\n(INu+\\n()Iu289 .ti\\n()Ru+\\n(INu290 .}f291 ..292 .deIP293 .ie!\\$1 \{.TP "\\$2"294 \&\\$1\}295 .el\{.sp\\n(PDu296 .ne1.1v297 .if!\\$2 .nr )I \\$2n298 .}f299 .ll\\n(LLu300 .in\\n()Ru+\\n(INu+\\n()Iu301 .lg\}302 ..303 .deTP304 .if!\\$1 \{.nr )I \\$1n305 .if\\$10 .nr )I \\n()M\}306 .sp\\n(PDu307 .ne1.1v308 .in\\n()Ru309 .lg0310 .ns311 .it1 }N312 .nr)E 1313 .di]B314 ..315 .deTF316 .IP "" "\w'\f5\\$1\ \ \fP'u"317 .PD0318 ..319 .de}1320 .ds]X \&\\*(]B\\321 .rm]B322 .nr)E 0323 .if!\\$1 .nr )I \\$1n324 .}f325 .ll\\n(LLu326 .in\\n()Ru+\\n(INu+\\n()Iu327 .ti\\n(INu328 .ie!\\n()Iu+\\n()Ru-\w\\*(]Xu-3p \{\\*(]X329 .br\}330 .el\\*(]X\h|\\n()Iu+\\n()Ru\c331 .}f332 .lg333 ..334 .de}N335 .if\\n()E .br336 .if\\n()E1 .di337 .if\\n()E0 .}f338 .if\\n()E1 .}1339 .if\\n()E2 .}2340 ..341 .deRS342 .nr]\\n+()p \\n()I343 .nr)\\n()p \\n()R344 .ie!\\$1 .nr )R +\\$1n345 .el.nr )R +\\n()I346 .nr)I \\n()Mu347 .}E348 ..349 .deRE350 .if!\\$1 \{.ie \\$10 .nr )p 1 1351 .el.nr )p \\$1 1 \}352 .ds]i \\*(]I\\n()p353 .ds]r \\*(]R\\n()p354 .nr)I \\*(]i355 .nr)R \\*(]r356 .if\\n()p .nr )p -1357 .}E358 ..359 '''\" .2C begin 2-column display, by diversion360 '''\" CC=amount of text that will fit on page361 '''\" CL=1 multicolumn in effect, else 0362 '''\" CI saved indent363 '''\" CB contains diverted text364 .de 2C365 .ne 2366 .nf367 .nr CC \\n(.t/1v*2v368 .nr CI \\n(IN369 .nr IN 0370 .di CB371 .nr CL 1372 .}E373 .dt \\n(CCu C1374 ..375 '''\" .1C return to 1-column376 .de 1C377 .nr CL 0378 .C1379 .fi380 ..381 '''\" end of diversion, at end of page or return to 1-column382 '''\" CC=pos of nominal column end383 .de C1384 .dt385 \!.C3386 .di387 .if \\n(dn \{.nr CC \\n(dnu/2u+\\n(nlu388 .wh \\n(CCu C2389 .mk390 .nf391 .nr IN \\n(CIu392 .}E393 .CB \}394 ..395 '''\" end of first column retrieved from diversion396 '''\" CC=pos of actual column end397 .de C2398 .wh \\n(CCu399 .mk CC400 .po +(\\n(LLu/2u)u401 .rt402 .if \\n(dn>1v .ns403 ..404 '''\" end of second column405 .de C3406 .br407 .po -(\\n(LLu/2u)u408 .if \\n(CC>\\n(nl .sp |\\n(CCu409 .ne 2410 ..411 .dePM412 .if\\$1 .nr !K 0413 .if\w\\$1 \{\414 .ie\\$1P .nr !K 1415 .el.ie \\$1BP .nr !K 3416 .el.ie \\$1BR .nr !K 4417 .el.nr !K 2 \}418 .if\\n(!K .wh -(\\n(:mu+5v) )G419 ..420 .de)G421 .if\\n(!K 'sp 2v422 .ie\\n(!K=1 \{\423 .iet .bd1 3424 .el.bd1 0425 .tlPRIVATE426 .bd1427 .tlThis information should not be disclosed to unauthorized persons.428 .tlIt is meant solely for use by authorized Bell System employees. \}429 .el.ie \\n(!K=3 \{\430 .iet .bd1 3431 .el.bd1 0432 .tlBELL LABORATORIES PROPRIETARY433 .bd1434 .tlNot for use or disclosure outside Bell Laboratories except by435 .tlwritten approval of the director of the distributing organization. \}436 .el.ie \\n(!K=4 \{\437 .iet .bd1 3438 .el.bd1 0439 .tlBELL LABORATORIES RESTRICTED440 .bd1441 .tlThe information herein is meant solely for use by authorized442 .tlBell Laboratories employees and is not to be disclosed to others. \}443 .el.if \\n(!K=2 \{\444 .iet .bd1 3445 .el.bd1 0446 .tlNOTICE447 .bd1448 .tlNot for use or disclosure outside the449 .tlBell System except under written agreement. \}450 ..451 .nr)s 0452 .ift .if \ns .nr )s 1453 .nr)t 0454 .ift .if !\ns .nr )t 1455 .if\n()s \{.nr )L 9i456 .nrLL 4.75i457 .nr)O .75i458 .nr)S 8459 .nr)V 9 \}460 .if\n()t \{.nr )L 11i461 .nrLL 6.5i462 .nr)O 1i463 .nr)S 9464 .nr)V 11 \}465 .ift \{.ds R ®466 .dsS \s\n()S467 ..\}468 .ifn \{.nr )L 11i469 .nrLL 6.5i470 .nr)O .463i471 .if '\*(.T'think' \{.nrLL 80n472 .nr)O 0\}473 .if '\*(.T'thinksmall' \{.nrLL 142n474 .vs 9p475 .nr)O 0\}476 .dsR (Reg.)477 .dsS478 ..\}479 .if\nT .nr LL 80n480 .if\nV>1 \{481 .nrLL 82n482 .nr)L 84v483 .rmul \}484 .nr)p 0 1485 .ds]I \\\\n(]486 .ds]R \\\\n()487 .if\nd0 .nr m \n(mo-1488 .if\nm0 .ds ]m January489 .if\nm1 .ds ]m February490 .if\nm2 .ds ]m March491 .if\nm3 .ds ]m April492 .if\nm4 .ds ]m May493 .if\nm5 .ds ]m June494 .if\nm6 .ds ]m July495 .if\nm7 .ds ]m August496 .if\nm8 .ds ]m September497 .if\nm9 .ds ]m October498 .if\nm10 .ds ]m November499 .if\nm11 .ds ]m December500 .ifn \{.nr m \nm+1501 .nr yD (\n(yr%100502 .af yD 01503 .ie\nd .ds ]W (last mod. \nm/\nd/\ny)504 .el.ds ]W (printed \n(mo/\n(dy/\n(yD)505 ..\}506 .if\n()s .ds ]W507 .if\n()t \{.ie \nd .ds ]W \*(]m \nd, 20\ny508 .el.ds ]W \*(]m \n(dy, 20\n(yr509 ..\}510 .pl\n()Lu511 .ll\n(LLu512 .lt\n(LLu513 .po\n()Ou514 .ift .tr \``\''515 .}f516 .if\n()s .nr :m 3.5v517 .if\n()t .nr :m 6v518 .ifn .nr :m 7v519 .ift .nr )M 3.6m520 .ifn .nr )M 5n521 .em}K522 .nr q \np523 .if!\np .nr p 1524 .pn \np