1.\" Copyright (c) 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\" notice, this list of conditions and the following disclaimer in the
11.\" documentation and/or other materials provided with the distribution.
12.\" 3. All advertising materials mentioning features or use of this software
13.\" must display the following acknowledgement:
14.\" This product includes software developed by the University of
15.\" California, Berkeley and its contributors.
16.\" 4. Neither the name of the University nor the names of its contributors
17.\" may be used to endorse or promote products derived from this software
18.\" without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)doc-common 8.1 (Berkeley) 06/08/93
33.\" $FreeBSD: head/contrib/groff/tmac/doc-common 75337 2001-04-09 13:02:20Z ru $
34.\"
35.\" %beginstrip%
36.nr %A 1
37.nr %J 1
38.nr %N 1
39.nr %O 1
40.nr %R 1
41.nr %T 1
42.nr %V 1
43.nr Ad 12n
44.nr Ac 3
45.nr Ao 12n
46.nr Ap 2
47.nr An 12n
48.nr Aq 12n
49.nr Ar 12n
50.nr Bc 3
51.nr Bl 1
52.nr Bo 12n
53.nr Bq 12n
54.nr Bx 12n
55.nr Cd 12n
56.nr Cm 10n
57.nr Dc 3
58.nr Do 10n
59.nr Dq 12n
60.nr Ds 6n
61.nr Dq 12n
62.nr Dv 12n
63.nr Ec 3
64.nr El 1
65.nr Eo 12n
66.nr Eq 12n
67.nr Em 10n
68.nr Er 17n
69.nr Ev 15n
70.nr Fa 12n
71.nr Fx 12n
72.nr Fl 10n
73.nr Fc 3
74.nr Fo 16n
75.nr Fn 16n
76.nr I1 6n
77.nr I2 12n
78.nr I3 18n
79.nr Ic 10n
80.nr Li 16n
81.nr Ms 6n
82.nr Nm 10n
83.nr No 12n
84.nr Ns 2
85.nr Oo 10n
86.nr Oc 3
87.nr Op 14n
88.nr Pa 32n
89.nr Pf 12n
90.nr Pc 3
91.nr Po 12n
92.nr Pq 12n
93.nr Ql 16n
94.nr Qc 3
95.nr Qo 12n
96.nr Qq 12n
97.nr Sc 3
98.nr So 12n
99.nr Sq 12n
100.nr Sy 6n
101.nr Sx 16n
102.nr Rv 1
103.nr Tn 10n
104.nr Ta 1
105.nr Tv 1
106.nr Tx 22n
107.nr Ux 10n
108.nr Va 12n
109.nr Xc 3
110.nr Xo 1
111.nr Xr 10n
112.nr Yr \n(yr+1900
113.ds sV \& \&
114.ds hV \&\ \&
115.ds iV \& \&
116.ds tV \&\\t\&
117.\" Punctuation values (3 = closing punctuation, 4 = opening)
118.nr z. 3
119.nr z, 3
120.nr z: 3
121.nr z; 3
122.nr z? 3
123.nr z! 3
124.nr z( 4
125.nr z) 3
126.nr z[ 4
127.nr z] 3
128.\" Matching pairs
129.ds z( z)
130.ds z[ z]
131.ds z< z>
132.\" This is disgusting, troff not parse ``if'' stmt properly
133.nr z0 0
134.nr z1 0
135.nr z2 0
136.nr z3 0
137.nr z4 0
138.nr z5 0
139.nr z6 0
140.nr z7 0
141.nr z8 0
142.nr z9 0
143.nr z# 0
144.\" Header assembly macros
145.de Dt
146.ds dT UNTITLED
147.ds vT LOCAL
148.ds cH Null
149.if !"\\$1"" .ds dT \\$1
150.if !"\\$2"" \{\
151. ds cH \\$2
152.\" . if "\\$3"" \{\
153. if \\$2>=1 .if \\$2<=9 \{\
154. ds vT FreeBSD Reference Manual
155. if "\\$2"1" .ds vT FreeBSD General Commands Manual
156. if "\\$2"2" .ds vT FreeBSD System Calls Manual
157. if "\\$2"3" .ds vT FreeBSD Library Functions Manual
158. if "\\$2"4" .ds vT FreeBSD Kernel Interfaces Manual
159. if "\\$2"5" .ds vT FreeBSD File Formats Manual
160. if "\\$2"6" .ds vT FreeBSD Games Manual
161. if "\\$2"7" .ds vT FreeBSD Miscellaneous Information Manual
162. if "\\$2"8" .ds vT FreeBSD System Manager's Manual
163. if "\\$2"9" .ds vT FreeBSD Kernel Developer's Manual
164. nr sN \\$2
165. \}
166. if "\\$2"unass" .ds vT DRAFT
167. if "\\$2"draft" .ds vT DRAFT
168. if "\\$2"paper" .ds vT UNTITLED
169.\" . \}
170.\}
171.if !"\\$3"" \{\
172. if "\\$3"USD" .ds vT FreeBSD User's Supplementary Documents
173. if "\\$3"PS1" .ds vT FreeBSD Programmers's Supplementary Documents
174. if "\\$3"AMD" .ds vT FreeBSD Ancestral Manual Documents
175. if "\\$3"SMM" .ds vT FreeBSD System Manager's Manual
176. if "\\$3"URM" .ds vT FreeBSD Reference Manual
177. if "\\$3"PRM" .ds vT FreeBSD Programmers's Manual
178. if "\\$3"IND" .ds vT FreeBSD Manual Master Index
179.\" . if "\\$3"CON" .ds vT FreeBSD Contributed Software Manual
180.\" . if "\\$3"IMP" .ds vT FreeBSD Implementation Notes
181.\" . if "\\$3"HOW" .ds vT FreeBSD How Pocket Manual
182. if "\\$3"LOCAL" .ds vT FreeBSD Local Manual
183. if "\\$3"tahoe" .as vT \ (Tahoe Architecture)
184. if "\\$3"vax" .as vT \ (VAX Architecture)
185. if "\\$3"hp300" .as vT \ (HP300 Architecture)
186. if "\\$3"i386" .as vT \ (i386 Architecture)
187. if "\\$3"Alpha" .as vT \ (Alpha Architecture)
188. if "\\*(vT"LOCAL" .ds vT \\$3
189.\}
190..
191.\" NS Os macro - Operating System (behaviour changes after first call)
192.\" . ds vT \f(CODRAFT\fP\ \ \-\-\ \ \\*(vT\ \ \-\-\ \ \f(CODRAFT
193.\" . ds dD \f(CODRAFT\fP\ \ \-\-\ \ \\*(dD\ \ \-\-\ \ \f(CODRAFT
194.\" .ds vT \s+4\f(CODRAFT\fP\s-4\ \ \-\-\ \ \\*(vT\ \ \-\-\ \ \s+4\f(CODRAFT\s-4
195.\" .ds dD \s+4\f(CODRAFT\fP\s-4\ \ \-\-\ \ \\*(dD\ \ \-\-\ \ \s+4\f(CODRAFT\s-4
196.de Os
197.ds oS Null
198.if "\\$1"" .ds oS BSD
199.if "\\$1"ATT" \{\
200. ds oS AT&T
201. if "\\$2"" .as oS \0UNIX
202. if "\\$2"7th" .as oS \07th Edition
203. if "\\$2"7" .as oS \07th Edition
204. if "\\$2"III" .as oS \0System III
205. if "\\$2"3" .as oS \0System III
206. if "\\$2"V" .as oS \0System V
207. if "\\$2"V.2" .as oS \0System V Release 2
208. if "\\$2"V.3" .as oS \0System V Release 3
209. if "\\$2"V.4" .as oS \0System V Release 4
210.\}
211.if "\\$1"BSD" \{\
212. if "\\$2"3" .ds oS 3rd Berkeley Distribution
213. if "\\$2"4" .ds oS 4th Berkeley Distribution
214. if "\\$2"4.1" .ds oS 4.1 Berkeley Distribution
215. if "\\$2"4.2" .ds oS 4.2 Berkeley Distribution
216. if "\\$2"4.3" .ds oS 4.3 Berkeley Distribution
217. if "\\$2"4.3T" .ds oS 4.3-Tahoe Berkeley Distribution
218. if "\\$2"4.3R" .ds oS 4.3-Reno Berkeley Distribution
219. if "\\$2"4.3t" .ds oS 4.3-Tahoe Berkeley Distribution
220. if "\\$2"4.3r" .ds oS 4.3-Reno Berkeley Distribution
221. if "\\$2"4.4" .ds oS 4.4BSD
222. if "\\*(oS"Null" .tm Unknown BSD version ``\\$2'' at line \\n(c.
223.\}
224.if "\\$1"FreeBSD" \{\
225. ie "\\$2"2" .ds oS FreeBSD 2.0
226. el .if !"\\$2"" .if !dFx*\\$2 .tm Unknown FreeBSD version ``\\$2'' at line \\n(c.
227.\}
228.if "\\*(oS"Null" \{\
229. ds oS \&\\$1
230. if !"\\$2"" .as oS \& \\$2
231.\}
232..
233.de Dd
234.if !"\\*(dD"" .nr gX 1
235.ie \\n(.$>0 \{\
236. ie \\n(.$==3 \{\
237. ds dD \\$1 \\$2 \\$3
238. \}
239. el \{\
240. if "\\n(mo"1" .ds dD January
241. if "\\n(mo"2" .ds dD February
242. if "\\n(mo"3" .ds dD March
243. if "\\n(mo"4" .ds dD April
244. if "\\n(mo"5" .ds dD May
245. if "\\n(mo"6" .ds dD June
246. if "\\n(mo"7" .ds dD July
247. if "\\n(mo"8" .ds dD August
248. if "\\n(mo"9" .ds dD September
249. if "\\n(mo"10" .ds dD October
250. if "\\n(mo"11" .ds dD November
251. if "\\n(mo"12" .ds dD December
252. as dD \&\ \\n(dy, \\n(Yr
253. \}
254.\}
255.el \{\
256. ds dD Epoch
257.\}
258..
259.de hM
260.ev 1
261.pL
262.if !\\n(cR 'sp \\n(Hmu
263.tl @\\*(Hs\\*(hT\fP@\\*(Vs\\*(vT\fP@\\*(Hs\\*(hT\fP@
264'sp \\n(Hmu
265.ev
266..
267.de fM
268.ie \\n(cR 'br
269.el \{\
270. ev 1
271. pL
272. if !\\n(cR \{\
273' sp \\n(Fmu
274. tl @\\*(Hs\\*(oS\fP@\\*(Vs\\*(dD\fP@%@
275' bp
276. \}
277. ev
278.\}
279..
280.de lM
281.\" We may still have a partial line in the enviroment. If this is the case,
282.\" and we happen to be on the last line of the page, the .fl will cause the
283.\" page to be ejected and troff will immediately exit. If we're in nroff
284.\" mode, this would be unfortunate, since we would never get a chance to
285.\" output the footer. So we fudge the page length, to make sure that the
286.\" last page is never ejected until we want it to be.
287.if \\n(cR .pl +3v
288.fl
289.if \\n(cR \{\
290' sp
291. tl @\\*(Hs\\*(oS\fP@\\*(Vs\\*(dD\fP@%@
292. pl \\n(nlu
293.\}
294..
295.de Pp
296.sp \\n(Ppu
297.if !\\n(cR .ne 2
298.ns
299..
300.de Lp
301.Pp
302..
303.de LP
304.tm Not a \-mdoc command: .LP
305..
306.de PP
307.tm Not a \-mdoc command: .PP
308..
309.de pp
310.tm Not a \-mdoc command: .pp
311..
312.de Nd
313\&\-\& \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
314..
315.de Ss
316.sp
317.if !\\n(cR .ne 2
318.ti -.25i
319\&\\*(sH\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6 \|\\$7 \|\\$8 \|\\$9
320\&\fP\s0
321.ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
322.if !\\n(cR .ne 2
323.br
324..
325.de Rd
326.tm MDOC REGISTER DUMP
327.tm Db==\\n(Db register DEBUG MODE
328.tm L[0-9] registers - stack of list types
329.tm L0==\\n(L0
330.tm L1==\\n(L1
331.tm L2==\\n(L2
332.tm L3==\\n(L3
333.tm L4==\\n(L4
334.tm L5==\\n(L5
335.tm L6==\\n(L6
336.tm L7==\\n(L7
337.tm L8==\\n(L8
338.tm L9==\\n(L9
339.tm O[0-9] registers - stack of indent
340.tm O0==\\n(O0
341.tm O1==\\n(O1
342.tm O2==\\n(O2
343.tm O3==\\n(O3
344.tm O4==\\n(O4
345.tm O5==\\n(O5
346.tm O6==\\n(O6
347.tm O7==\\n(O7
348.tm O8==\\n(O8
349.tm O9==\\n(O9
350.tm aC==\\n(aC register argument counter (aV/fV)
351.tm aJ==\\n(aJ register (for vR)
352.tm aN==\\n(aN register
353.tm aP==\\n(aP register argument pointer (aV)
354.tm aT==\\n(aT register argument type
355.tm aa==\\n(aa local register
356.tm bK==\\n(bK register - Book Name flag
357.tm cF==\\n(cF register save current font
358.tm cI==\\n(cI register - column indent width
359.tm cZ==\\n(cZ register save current font size
360.tm dK==\\n(dK register - Date flag
361.tm d[0-9] registers - display-type stack
362.tm d0==\\n(d0
363.tm d1==\\n(d1
364.tm d2==\\n(d2
365.tm d3==\\n(d3
366.tm d4==\\n(d4
367.tm d5==\\n(d5
368.tm d6==\\n(d6
369.tm d7==\\n(d7
370.tm d8==\\n(d8
371.tm d9==\\n(d9
372.tm dZ==\\n(dZ register diversion count
373.tm fD==\\n(fD register subroutine test (in synopsis only)
374.tm fV==\\n(fV register argument counter (must set to \\n(.$ prior to
375.tm fY==\\n(fY register - dick with old style function declarations (fortran)
376.tm fZ==\\n(fZ register also subroutine count (in synopsis only)
377.tm h[0-9] register horizontal tag stack (continuous if 1, break if
378.tm h0==\\n(h0
379.tm h1==\\n(h1
380.tm h2==\\n(h2
381.tm h3==\\n(h3
382.tm h4==\\n(h4
383.tm h5==\\n(h5
384.tm h6==\\n(h6
385.tm h7==\\n(h7
386.tm h8==\\n(h8
387.tm h9==\\n(h9
388.tm iD==\\n(iD local register
389.tm iI==\\n(iI local register (indent for inline debug mode)
390.tm iN==\\n(iN register DEBUG MODE (inline if 1, to stderr if
391.tm iS==\\n(iS register - indent second command line in a synopsis
392.tm jK==\\n(jK register - [reference] Journal Name flag
393.tm jM==\\n(jM local register
394.tm jN==\\n(jN local register
395.tm lC==\\n(lC register - list type stack counter
396.tm lK==\\n(lK register count of lines read from input file
397.tm nK==\\n(nK register - [reference] issue number flag
398.tm nU==\\n(nU register count
399.tm oK==\\n(oK register - [reference] optional information flag
400.tm oM==\\n(oM register (extension possible)
401.tm o[0-9] register offset stack (nested tags)
402.tm o0==\\n(o0
403.tm o1==\\n(o1
404.tm o2==\\n(o2
405.tm o3==\\n(o3
406.tm o4==\\n(o4
407.tm o5==\\n(o5
408.tm o6==\\n(o6
409.tm o7==\\n(o7
410.tm o8==\\n(o8
411.tm o9==\\n(o9
412.tm oM==\\n(oM register open ended line flag
413.tm pK==\\n(pK register - [reference] page number flag
414.tm qK==\\n(qK register - Corporate or Foreign Author flag
415.tm rK==\\n(rK register - [reference] report flag
416.tm rS==\\n(rS register - Reference Start flag
417.tm sM==\\n(sM register - default is one (space mode on)
418.tm tK==\\n(tK register - reference title flag
419.tm tP==\\n(tP register tag flag (for diversions)
420.tm tX==\\n(tX register (initial class)
421.tm tY==\\n(tY register (next possible lC value)
422.tm t[0-9] register tag string stack (nested tags)
423.tm t0==\\n(t0
424.tm t1==\\n(t1
425.tm t2==\\n(t2
426.tm t3==\\n(t3
427.tm t4==\\n(t4
428.tm t5==\\n(t5
429.tm t6==\\n(t6
430.tm t7==\\n(t7
431.tm t8==\\n(t8
432.tm t9==\\n(t9
433.tm uK==\\n(uK register - reference author(s) counter
434.tm vK==\\n(vK register - reference volume flag
435.tm v[0-9] register vertical tag break stack
436.tm v0==\\n(v0
437.tm v1==\\n(v1
438.tm v2==\\n(v2
439.tm v3==\\n(v3
440.tm v4==\\n(v4
441.tm v5==\\n(v5
442.tm v6==\\n(v6
443.tm v7==\\n(v7
444.tm v8==\\n(v8
445.tm v9==\\n(v9
446.tm w[0-9] register tag stack (nested tags)
447.tm w0==\\n(w0
448.tm w1==\\n(w1
449.tm w2==\\n(w2
450.tm w3==\\n(w3
451.tm w4==\\n(w4
452.tm w5==\\n(w5
453.tm w6==\\n(w6
454.tm w7==\\n(w7
455.tm w8==\\n(w8
456.tm w9==\\n(w9
457.tm xX==\\n(xX local register
458.tm END OF REGISTER DUMP
459..
460.\" Ns Lb macro - Formal library names for LIBRARY sections
461.\" note: this macro does not handle punctuation
462.\" it is really only intended for standalone use.
463.\" Note: please don't forget to update mdoc.samples(7)' `Library name' list
464.\" when adding new library
465.de Lb
466.nr cF \\n(.f
467.nr cZ \\n(.s
468.ds aa \&\f\\n(cF\s\\n(cZ
469.if !\\n(.$==1 .tm Usage: .Lb [library name]
470.if "\\$1"libc" \&Standard C Library (libc, -lc)
471.if "\\$1"libc_r" \&Reentrant C Library (libc_r, -lc_r)
472.if "\\$1"libcalendar" \&Calendar Arithmetic Library (libcalendar, -lcalendar)
473.if "\\$1"libcam" \&Common Access Method User Library (libcam, -lcam)
474.if "\\$1"libcipher" \&FreeSec Crypt Library (libcipher, -lcipher)
475.if "\\$1"libcompat" \&Compatibility Library (libcompat, -lcompat)
476.if "\\$1"libcrypt" \&Crypt Library (libcrypt, -lcrypt)
477.if "\\$1"libdevstat" \&Device Statistics Library (libdevstat, -ldevstat)
478.if "\\$1"libdisk" \&Interface to Slice and Partition Labels Library (libdisk, -ldisk)
479.if "\\$1"libedit" \&Line Editor and History Library (libedit, -ledit)
480.if "\\$1"libfetch" \&File Transfer Library (libfetch, -lfetch)
481.if "\\$1"libipsec" \&IPsec Support Library (libipsec, -lipsec)
482.if "\\$1"libipx" \&IPX Address Conversion Support Library (libipx, -lipx)
483.if "\\$1"libkvm" \&Kernel Data Access Library (libkvm, -lkvm)
484.if "\\$1"libm" \&Math Library (libm, -lm)
485.if "\\$1"libmd" \&Message Digest (MD4, MD5, etc.) Support Library (libmd, -lmd)
486.if "\\$1"libnetgraph" \&Netgraph User Library (libnetgraph, -lnetgraph)
487.if "\\$1"librpcsvc" \&RPC Service Library (librpcsvc, -lrpcsvc)
488.if "\\$1"libskey" \&S/Key Password Control Table Access Library (libskey, -lskey)
489.if "\\$1"libusb" \&USB HID access routines library (libusb, -lusb)
490.if "\\$1"libutil" \&System Utilities Library (libutil, -lutil)
491.if "\\$1"libvgl" \&Video Graphics Library (libvgl, -lvgl)
492..
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\" notice, this list of conditions and the following disclaimer in the
11.\" documentation and/or other materials provided with the distribution.
12.\" 3. All advertising materials mentioning features or use of this software
13.\" must display the following acknowledgement:
14.\" This product includes software developed by the University of
15.\" California, Berkeley and its contributors.
16.\" 4. Neither the name of the University nor the names of its contributors
17.\" may be used to endorse or promote products derived from this software
18.\" without specific prior written permission.
19.\"
20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.\" @(#)doc-common 8.1 (Berkeley) 06/08/93
33.\" $FreeBSD: head/contrib/groff/tmac/doc-common 75337 2001-04-09 13:02:20Z ru $
34.\"
35.\" %beginstrip%
36.nr %A 1
37.nr %J 1
38.nr %N 1
39.nr %O 1
40.nr %R 1
41.nr %T 1
42.nr %V 1
43.nr Ad 12n
44.nr Ac 3
45.nr Ao 12n
46.nr Ap 2
47.nr An 12n
48.nr Aq 12n
49.nr Ar 12n
50.nr Bc 3
51.nr Bl 1
52.nr Bo 12n
53.nr Bq 12n
54.nr Bx 12n
55.nr Cd 12n
56.nr Cm 10n
57.nr Dc 3
58.nr Do 10n
59.nr Dq 12n
60.nr Ds 6n
61.nr Dq 12n
62.nr Dv 12n
63.nr Ec 3
64.nr El 1
65.nr Eo 12n
66.nr Eq 12n
67.nr Em 10n
68.nr Er 17n
69.nr Ev 15n
70.nr Fa 12n
71.nr Fx 12n
72.nr Fl 10n
73.nr Fc 3
74.nr Fo 16n
75.nr Fn 16n
76.nr I1 6n
77.nr I2 12n
78.nr I3 18n
79.nr Ic 10n
80.nr Li 16n
81.nr Ms 6n
82.nr Nm 10n
83.nr No 12n
84.nr Ns 2
85.nr Oo 10n
86.nr Oc 3
87.nr Op 14n
88.nr Pa 32n
89.nr Pf 12n
90.nr Pc 3
91.nr Po 12n
92.nr Pq 12n
93.nr Ql 16n
94.nr Qc 3
95.nr Qo 12n
96.nr Qq 12n
97.nr Sc 3
98.nr So 12n
99.nr Sq 12n
100.nr Sy 6n
101.nr Sx 16n
102.nr Rv 1
103.nr Tn 10n
104.nr Ta 1
105.nr Tv 1
106.nr Tx 22n
107.nr Ux 10n
108.nr Va 12n
109.nr Xc 3
110.nr Xo 1
111.nr Xr 10n
112.nr Yr \n(yr+1900
113.ds sV \& \&
114.ds hV \&\ \&
115.ds iV \& \&
116.ds tV \&\\t\&
117.\" Punctuation values (3 = closing punctuation, 4 = opening)
118.nr z. 3
119.nr z, 3
120.nr z: 3
121.nr z; 3
122.nr z? 3
123.nr z! 3
124.nr z( 4
125.nr z) 3
126.nr z[ 4
127.nr z] 3
128.\" Matching pairs
129.ds z( z)
130.ds z[ z]
131.ds z< z>
132.\" This is disgusting, troff not parse ``if'' stmt properly
133.nr z0 0
134.nr z1 0
135.nr z2 0
136.nr z3 0
137.nr z4 0
138.nr z5 0
139.nr z6 0
140.nr z7 0
141.nr z8 0
142.nr z9 0
143.nr z# 0
144.\" Header assembly macros
145.de Dt
146.ds dT UNTITLED
147.ds vT LOCAL
148.ds cH Null
149.if !"\\$1"" .ds dT \\$1
150.if !"\\$2"" \{\
151. ds cH \\$2
152.\" . if "\\$3"" \{\
153. if \\$2>=1 .if \\$2<=9 \{\
154. ds vT FreeBSD Reference Manual
155. if "\\$2"1" .ds vT FreeBSD General Commands Manual
156. if "\\$2"2" .ds vT FreeBSD System Calls Manual
157. if "\\$2"3" .ds vT FreeBSD Library Functions Manual
158. if "\\$2"4" .ds vT FreeBSD Kernel Interfaces Manual
159. if "\\$2"5" .ds vT FreeBSD File Formats Manual
160. if "\\$2"6" .ds vT FreeBSD Games Manual
161. if "\\$2"7" .ds vT FreeBSD Miscellaneous Information Manual
162. if "\\$2"8" .ds vT FreeBSD System Manager's Manual
163. if "\\$2"9" .ds vT FreeBSD Kernel Developer's Manual
164. nr sN \\$2
165. \}
166. if "\\$2"unass" .ds vT DRAFT
167. if "\\$2"draft" .ds vT DRAFT
168. if "\\$2"paper" .ds vT UNTITLED
169.\" . \}
170.\}
171.if !"\\$3"" \{\
172. if "\\$3"USD" .ds vT FreeBSD User's Supplementary Documents
173. if "\\$3"PS1" .ds vT FreeBSD Programmers's Supplementary Documents
174. if "\\$3"AMD" .ds vT FreeBSD Ancestral Manual Documents
175. if "\\$3"SMM" .ds vT FreeBSD System Manager's Manual
176. if "\\$3"URM" .ds vT FreeBSD Reference Manual
177. if "\\$3"PRM" .ds vT FreeBSD Programmers's Manual
178. if "\\$3"IND" .ds vT FreeBSD Manual Master Index
179.\" . if "\\$3"CON" .ds vT FreeBSD Contributed Software Manual
180.\" . if "\\$3"IMP" .ds vT FreeBSD Implementation Notes
181.\" . if "\\$3"HOW" .ds vT FreeBSD How Pocket Manual
182. if "\\$3"LOCAL" .ds vT FreeBSD Local Manual
183. if "\\$3"tahoe" .as vT \ (Tahoe Architecture)
184. if "\\$3"vax" .as vT \ (VAX Architecture)
185. if "\\$3"hp300" .as vT \ (HP300 Architecture)
186. if "\\$3"i386" .as vT \ (i386 Architecture)
187. if "\\$3"Alpha" .as vT \ (Alpha Architecture)
188. if "\\*(vT"LOCAL" .ds vT \\$3
189.\}
190..
191.\" NS Os macro - Operating System (behaviour changes after first call)
192.\" . ds vT \f(CODRAFT\fP\ \ \-\-\ \ \\*(vT\ \ \-\-\ \ \f(CODRAFT
193.\" . ds dD \f(CODRAFT\fP\ \ \-\-\ \ \\*(dD\ \ \-\-\ \ \f(CODRAFT
194.\" .ds vT \s+4\f(CODRAFT\fP\s-4\ \ \-\-\ \ \\*(vT\ \ \-\-\ \ \s+4\f(CODRAFT\s-4
195.\" .ds dD \s+4\f(CODRAFT\fP\s-4\ \ \-\-\ \ \\*(dD\ \ \-\-\ \ \s+4\f(CODRAFT\s-4
196.de Os
197.ds oS Null
198.if "\\$1"" .ds oS BSD
199.if "\\$1"ATT" \{\
200. ds oS AT&T
201. if "\\$2"" .as oS \0UNIX
202. if "\\$2"7th" .as oS \07th Edition
203. if "\\$2"7" .as oS \07th Edition
204. if "\\$2"III" .as oS \0System III
205. if "\\$2"3" .as oS \0System III
206. if "\\$2"V" .as oS \0System V
207. if "\\$2"V.2" .as oS \0System V Release 2
208. if "\\$2"V.3" .as oS \0System V Release 3
209. if "\\$2"V.4" .as oS \0System V Release 4
210.\}
211.if "\\$1"BSD" \{\
212. if "\\$2"3" .ds oS 3rd Berkeley Distribution
213. if "\\$2"4" .ds oS 4th Berkeley Distribution
214. if "\\$2"4.1" .ds oS 4.1 Berkeley Distribution
215. if "\\$2"4.2" .ds oS 4.2 Berkeley Distribution
216. if "\\$2"4.3" .ds oS 4.3 Berkeley Distribution
217. if "\\$2"4.3T" .ds oS 4.3-Tahoe Berkeley Distribution
218. if "\\$2"4.3R" .ds oS 4.3-Reno Berkeley Distribution
219. if "\\$2"4.3t" .ds oS 4.3-Tahoe Berkeley Distribution
220. if "\\$2"4.3r" .ds oS 4.3-Reno Berkeley Distribution
221. if "\\$2"4.4" .ds oS 4.4BSD
222. if "\\*(oS"Null" .tm Unknown BSD version ``\\$2'' at line \\n(c.
223.\}
224.if "\\$1"FreeBSD" \{\
225. ie "\\$2"2" .ds oS FreeBSD 2.0
226. el .if !"\\$2"" .if !dFx*\\$2 .tm Unknown FreeBSD version ``\\$2'' at line \\n(c.
227.\}
228.if "\\*(oS"Null" \{\
229. ds oS \&\\$1
230. if !"\\$2"" .as oS \& \\$2
231.\}
232..
233.de Dd
234.if !"\\*(dD"" .nr gX 1
235.ie \\n(.$>0 \{\
236. ie \\n(.$==3 \{\
237. ds dD \\$1 \\$2 \\$3
238. \}
239. el \{\
240. if "\\n(mo"1" .ds dD January
241. if "\\n(mo"2" .ds dD February
242. if "\\n(mo"3" .ds dD March
243. if "\\n(mo"4" .ds dD April
244. if "\\n(mo"5" .ds dD May
245. if "\\n(mo"6" .ds dD June
246. if "\\n(mo"7" .ds dD July
247. if "\\n(mo"8" .ds dD August
248. if "\\n(mo"9" .ds dD September
249. if "\\n(mo"10" .ds dD October
250. if "\\n(mo"11" .ds dD November
251. if "\\n(mo"12" .ds dD December
252. as dD \&\ \\n(dy, \\n(Yr
253. \}
254.\}
255.el \{\
256. ds dD Epoch
257.\}
258..
259.de hM
260.ev 1
261.pL
262.if !\\n(cR 'sp \\n(Hmu
263.tl @\\*(Hs\\*(hT\fP@\\*(Vs\\*(vT\fP@\\*(Hs\\*(hT\fP@
264'sp \\n(Hmu
265.ev
266..
267.de fM
268.ie \\n(cR 'br
269.el \{\
270. ev 1
271. pL
272. if !\\n(cR \{\
273' sp \\n(Fmu
274. tl @\\*(Hs\\*(oS\fP@\\*(Vs\\*(dD\fP@%@
275' bp
276. \}
277. ev
278.\}
279..
280.de lM
281.\" We may still have a partial line in the enviroment. If this is the case,
282.\" and we happen to be on the last line of the page, the .fl will cause the
283.\" page to be ejected and troff will immediately exit. If we're in nroff
284.\" mode, this would be unfortunate, since we would never get a chance to
285.\" output the footer. So we fudge the page length, to make sure that the
286.\" last page is never ejected until we want it to be.
287.if \\n(cR .pl +3v
288.fl
289.if \\n(cR \{\
290' sp
291. tl @\\*(Hs\\*(oS\fP@\\*(Vs\\*(dD\fP@%@
292. pl \\n(nlu
293.\}
294..
295.de Pp
296.sp \\n(Ppu
297.if !\\n(cR .ne 2
298.ns
299..
300.de Lp
301.Pp
302..
303.de LP
304.tm Not a \-mdoc command: .LP
305..
306.de PP
307.tm Not a \-mdoc command: .PP
308..
309.de pp
310.tm Not a \-mdoc command: .pp
311..
312.de Nd
313\&\-\& \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
314..
315.de Ss
316.sp
317.if !\\n(cR .ne 2
318.ti -.25i
319\&\\*(sH\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6 \|\\$7 \|\\$8 \|\\$9
320\&\fP\s0
321.ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
322.if !\\n(cR .ne 2
323.br
324..
325.de Rd
326.tm MDOC REGISTER DUMP
327.tm Db==\\n(Db register DEBUG MODE
328.tm L[0-9] registers - stack of list types
329.tm L0==\\n(L0
330.tm L1==\\n(L1
331.tm L2==\\n(L2
332.tm L3==\\n(L3
333.tm L4==\\n(L4
334.tm L5==\\n(L5
335.tm L6==\\n(L6
336.tm L7==\\n(L7
337.tm L8==\\n(L8
338.tm L9==\\n(L9
339.tm O[0-9] registers - stack of indent
340.tm O0==\\n(O0
341.tm O1==\\n(O1
342.tm O2==\\n(O2
343.tm O3==\\n(O3
344.tm O4==\\n(O4
345.tm O5==\\n(O5
346.tm O6==\\n(O6
347.tm O7==\\n(O7
348.tm O8==\\n(O8
349.tm O9==\\n(O9
350.tm aC==\\n(aC register argument counter (aV/fV)
351.tm aJ==\\n(aJ register (for vR)
352.tm aN==\\n(aN register
353.tm aP==\\n(aP register argument pointer (aV)
354.tm aT==\\n(aT register argument type
355.tm aa==\\n(aa local register
356.tm bK==\\n(bK register - Book Name flag
357.tm cF==\\n(cF register save current font
358.tm cI==\\n(cI register - column indent width
359.tm cZ==\\n(cZ register save current font size
360.tm dK==\\n(dK register - Date flag
361.tm d[0-9] registers - display-type stack
362.tm d0==\\n(d0
363.tm d1==\\n(d1
364.tm d2==\\n(d2
365.tm d3==\\n(d3
366.tm d4==\\n(d4
367.tm d5==\\n(d5
368.tm d6==\\n(d6
369.tm d7==\\n(d7
370.tm d8==\\n(d8
371.tm d9==\\n(d9
372.tm dZ==\\n(dZ register diversion count
373.tm fD==\\n(fD register subroutine test (in synopsis only)
374.tm fV==\\n(fV register argument counter (must set to \\n(.$ prior to
375.tm fY==\\n(fY register - dick with old style function declarations (fortran)
376.tm fZ==\\n(fZ register also subroutine count (in synopsis only)
377.tm h[0-9] register horizontal tag stack (continuous if 1, break if
378.tm h0==\\n(h0
379.tm h1==\\n(h1
380.tm h2==\\n(h2
381.tm h3==\\n(h3
382.tm h4==\\n(h4
383.tm h5==\\n(h5
384.tm h6==\\n(h6
385.tm h7==\\n(h7
386.tm h8==\\n(h8
387.tm h9==\\n(h9
388.tm iD==\\n(iD local register
389.tm iI==\\n(iI local register (indent for inline debug mode)
390.tm iN==\\n(iN register DEBUG MODE (inline if 1, to stderr if
391.tm iS==\\n(iS register - indent second command line in a synopsis
392.tm jK==\\n(jK register - [reference] Journal Name flag
393.tm jM==\\n(jM local register
394.tm jN==\\n(jN local register
395.tm lC==\\n(lC register - list type stack counter
396.tm lK==\\n(lK register count of lines read from input file
397.tm nK==\\n(nK register - [reference] issue number flag
398.tm nU==\\n(nU register count
399.tm oK==\\n(oK register - [reference] optional information flag
400.tm oM==\\n(oM register (extension possible)
401.tm o[0-9] register offset stack (nested tags)
402.tm o0==\\n(o0
403.tm o1==\\n(o1
404.tm o2==\\n(o2
405.tm o3==\\n(o3
406.tm o4==\\n(o4
407.tm o5==\\n(o5
408.tm o6==\\n(o6
409.tm o7==\\n(o7
410.tm o8==\\n(o8
411.tm o9==\\n(o9
412.tm oM==\\n(oM register open ended line flag
413.tm pK==\\n(pK register - [reference] page number flag
414.tm qK==\\n(qK register - Corporate or Foreign Author flag
415.tm rK==\\n(rK register - [reference] report flag
416.tm rS==\\n(rS register - Reference Start flag
417.tm sM==\\n(sM register - default is one (space mode on)
418.tm tK==\\n(tK register - reference title flag
419.tm tP==\\n(tP register tag flag (for diversions)
420.tm tX==\\n(tX register (initial class)
421.tm tY==\\n(tY register (next possible lC value)
422.tm t[0-9] register tag string stack (nested tags)
423.tm t0==\\n(t0
424.tm t1==\\n(t1
425.tm t2==\\n(t2
426.tm t3==\\n(t3
427.tm t4==\\n(t4
428.tm t5==\\n(t5
429.tm t6==\\n(t6
430.tm t7==\\n(t7
431.tm t8==\\n(t8
432.tm t9==\\n(t9
433.tm uK==\\n(uK register - reference author(s) counter
434.tm vK==\\n(vK register - reference volume flag
435.tm v[0-9] register vertical tag break stack
436.tm v0==\\n(v0
437.tm v1==\\n(v1
438.tm v2==\\n(v2
439.tm v3==\\n(v3
440.tm v4==\\n(v4
441.tm v5==\\n(v5
442.tm v6==\\n(v6
443.tm v7==\\n(v7
444.tm v8==\\n(v8
445.tm v9==\\n(v9
446.tm w[0-9] register tag stack (nested tags)
447.tm w0==\\n(w0
448.tm w1==\\n(w1
449.tm w2==\\n(w2
450.tm w3==\\n(w3
451.tm w4==\\n(w4
452.tm w5==\\n(w5
453.tm w6==\\n(w6
454.tm w7==\\n(w7
455.tm w8==\\n(w8
456.tm w9==\\n(w9
457.tm xX==\\n(xX local register
458.tm END OF REGISTER DUMP
459..
460.\" Ns Lb macro - Formal library names for LIBRARY sections
461.\" note: this macro does not handle punctuation
462.\" it is really only intended for standalone use.
463.\" Note: please don't forget to update mdoc.samples(7)' `Library name' list
464.\" when adding new library
465.de Lb
466.nr cF \\n(.f
467.nr cZ \\n(.s
468.ds aa \&\f\\n(cF\s\\n(cZ
469.if !\\n(.$==1 .tm Usage: .Lb [library name]
470.if "\\$1"libc" \&Standard C Library (libc, -lc)
471.if "\\$1"libc_r" \&Reentrant C Library (libc_r, -lc_r)
472.if "\\$1"libcalendar" \&Calendar Arithmetic Library (libcalendar, -lcalendar)
473.if "\\$1"libcam" \&Common Access Method User Library (libcam, -lcam)
474.if "\\$1"libcipher" \&FreeSec Crypt Library (libcipher, -lcipher)
475.if "\\$1"libcompat" \&Compatibility Library (libcompat, -lcompat)
476.if "\\$1"libcrypt" \&Crypt Library (libcrypt, -lcrypt)
477.if "\\$1"libdevstat" \&Device Statistics Library (libdevstat, -ldevstat)
478.if "\\$1"libdisk" \&Interface to Slice and Partition Labels Library (libdisk, -ldisk)
479.if "\\$1"libedit" \&Line Editor and History Library (libedit, -ledit)
480.if "\\$1"libfetch" \&File Transfer Library (libfetch, -lfetch)
481.if "\\$1"libipsec" \&IPsec Support Library (libipsec, -lipsec)
482.if "\\$1"libipx" \&IPX Address Conversion Support Library (libipx, -lipx)
483.if "\\$1"libkvm" \&Kernel Data Access Library (libkvm, -lkvm)
484.if "\\$1"libm" \&Math Library (libm, -lm)
485.if "\\$1"libmd" \&Message Digest (MD4, MD5, etc.) Support Library (libmd, -lmd)
486.if "\\$1"libnetgraph" \&Netgraph User Library (libnetgraph, -lnetgraph)
487.if "\\$1"librpcsvc" \&RPC Service Library (librpcsvc, -lrpcsvc)
488.if "\\$1"libskey" \&S/Key Password Control Table Access Library (libskey, -lskey)
489.if "\\$1"libusb" \&USB HID access routines library (libusb, -lusb)
490.if "\\$1"libutil" \&System Utilities Library (libutil, -lutil)
491.if "\\$1"libvgl" \&Video Graphics Library (libvgl, -lvgl)
492..