-.TH achfile 1 "26 Feb 1998" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: achfile
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 26 Feb 1998
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "ACHFILE" "1" "26 Feb 1998" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
achfile \- change type and/or creator of Apple Macintosh files (netatalk format)
-.SH SYNOPSIS
-\fBachfile\fR [ \-t \fBtype\fR ] [ \-c \fBcreator\fR ] \fBfile\fR \&...
-.SH DESCRIPTION
-achfile changes the Macintosh type and/or creator
-of the \fIfile\fR arguments which have a
-corresponding .AppleDouble file.
-.SH OPTIONS
-\fB\-t\fR \fItype\fR change the type.
+.SH "SYNOPSIS"
+.HP \w'\fBachfile\fR\fB\fR\ 'u
+\fBachfile\fR\fB\fR [\-t\ \fItype\fR] [\-c\ \fIcreator\fR] \fIfile\fR...
+.SH "DESCRIPTION"
+.PP
+\fBachfile\fR
+changes the Macintosh type and/or creator of the
+\fIfile\fR
+arguments which have a corresponding \&.AppleDouble file\&.
+.SH "OPTIONS"
+.PP
+\fB\-t\fR
+\fItype\fR
+change the type\&.
+.PP
+\fB\-c\fR
+\fIcreator\fR
+change the creator\&.
+.SH "DIAGNOSTICS"
.PP
-\fB\-c\fR \fIcreator\fR change the
-creator.
-.SH DIAGNOSTICS
returns exit status 0 if all files changed successfully
.SH "SEE ALSO"
+.PP
\fBafile\fR(1),
\fBafpd\fR(8)
-
-.TH aecho 1 "17 Dec 1991" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: aecho
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 17 Dec 1991
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "AECHO" "1" "17 Dec 1991" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
aecho \- send AppleTalk Echo Protocol packets to network hosts
-.SH SYNOPSIS
-aecho [ \fB\-c\fR\fI count\fR
-] ( address | nbpname )
-.SH DESCRIPTION
-aecho repeatedly sends an Apple Echo Protocol
-(AEP) packet to the host specified by the given AppleTalk
-address or nbpname and reports
-whether a reply was received. Requests are sent at the rate of one per
-second.
+.SH "SYNOPSIS"
.PP
-address is parsed by
-\fBatalk_aton\fR(3).
-nbpname is parsed by \fBnbp_name\fR(3).
-The nbp type defaults to `\fIWorkstation\fR'.
+\fBaecho\fR\fB\fR\fB\fR
+[
+\fB\-c\fR\fI count\fR
+] (
+\fBaddress\fR
+|
+\fBnbpname\fR
+)
+.SH "DESCRIPTION"
+.PP
+\fBaecho\fR
+repeatedly sends an Apple Echo Protocol (AEP) packet to the host specified by the given AppleTalk
+\fBaddress\fR
+or
+\fBnbpname\fR
+and reports whether a reply was received\&. Requests are sent at the rate of one per second\&.
+.PP
+\fBaddress\fR
+is parsed by
+\fBatalk_aton\fR(3)\&.
+\fBnbpname\fR
+is parsed by
+\fBnbp_name\fR(3)\&. The nbp type defaults to `\fBWorkstation\fR\'\&.
.PP
-When aecho is terminated, it reports the number
-of packets sent, the number of responses received, and the percentage of
-packets lost. If any responses were received, the minimum, average, and
-maximum round trip times are reported.
-.SH EXAMPLE
-Check to see if a particular host is up and responding to AEP
-packets:
+When
+\fBaecho\fR
+is terminated, it reports the number of packets sent, the number of responses received, and the percentage of packets lost\&. If any responses were received, the minimum, average, and maximum round trip times are reported\&.
+.SH "EXAMPLE"
.PP
+Check to see if a particular host is up and responding to AEP packets:
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
example% \fBaecho bloodsport
-11 bytes from 8195.13: aep_seq=0. time=10. ms
-11 bytes from 8195.13: aep_seq=1. time=10. ms
-11 bytes from 8195.13: aep_seq=2. time=10. ms
-11 bytes from 8195.13: aep_seq=3. time=10. ms
-11 bytes from 8195.13: aep_seq=4. time=10. ms
-11 bytes from 8195.13: aep_seq=5. time=9. ms
-^C
-\-\-\-\-8195.13 AEP Statistics\-\-\-\-
+\fR\fB11 bytes from 8195\&.13: aep_seq=0\&. time=10\&. ms
+11 bytes from 8195\&.13: aep_seq=1\&. time=10\&. ms
+11 bytes from 8195\&.13: aep_seq=2\&. time=10\&. ms
+11 bytes from 8195\&.13: aep_seq=3\&. time=10\&. ms
+11 bytes from 8195\&.13: aep_seq=4\&. time=10\&. ms
+11 bytes from 8195\&.13: aep_seq=5\&. time=9\&. ms\fR\fB
+\fR\fB\fB^C\fR\fR\fB
+\fR\fB\-\-\-\-8195\&.13 AEP Statistics\-\-\-\-
6 packets sent, 6 packets received, 0% packet loss
round\-trip (ms) min/avg/max = 9/9/10
-\fR.fi
-.SH OPTIONS
-.TP
+\fR
+.fi
+.if n \{\
+.RE
+.\}
+.SH "OPTIONS"
+.PP
\fB\-c\fR\fI count\fR
-Stop after \fIcount\fR packets.
+.RS 4
+Stop after
+\fIcount\fR
+packets\&.
+.RE
.SH "SEE ALSO"
+.PP
\fBping\fR(1),
\fBatalk_aton\fR(3),
\fBnbp_name\fR(3),
\fBaep\fR(4),
-\fBatalkd\fR(8).
-
+\fBatalkd\fR(8)\&.
-.TH afile 1 "26 Feb 1998" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: afile
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 26 Feb 1998
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "AFILE" "1" "26 Feb 1998" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
afile \- display type and creator of Apple Macintosh files (netatalk format)
-.SH SYNOPSIS
-\fBafile\fR [\-a] \fBfile\fR \&...
-.sp 1
-.SH DESCRIPTION
-afile displays the name and Macintosh type and
-creator of the \fIfile\fR arguments. Tests
-whether the file is an AppleDouble header, in which case it checks the
-corresponding data fork exists, or assumes it is a data fork in which case
-it looks for the corresponding AppleDouble to find the type/creator
-information.
-.PP
-afile does not look at any of the extension
-mapping files such as AppleVolumes.system.
-.SH OPTIONS
-.TP
+.SH "SYNOPSIS"
+.HP \w'\fBafile\fR\fB\fR\ 'u
+\fBafile\fR\fB\fR [\-a] \fIfile\fR...
+.br
+
+.SH "DESCRIPTION"
+.PP
+\fBafile\fR
+displays the name and Macintosh type and creator of the
+\fIfile\fR
+arguments\&. Tests whether the file is an AppleDouble header, in which case it checks the corresponding data fork exists, or assumes it is a data fork in which case it looks for the corresponding AppleDouble to find the type/creator information\&.
+.PP
+\fBafile\fR
+does not look at any of the extension mapping files such as AppleVolumes\&.system\&.
+.SH "OPTIONS"
+.PP
\fB\-a\fR
-Include directories and data files of unknown type (i.e.
-without corresponding AppleDouble) in output.
-.SH DIAGNOSTICS
-returns exit status 0 if all files have a corresponding valid
-\&.AppleDouble header or data fork, or 99 for bad command line options.
-Otherwise it returns the following error code relating to the last invalid
-file.
+.RS 4
+Include directories and data files of unknown type (i\&.e\&. without corresponding AppleDouble) in output\&.
+.RE
+.SH "DIAGNOSTICS"
.PP
-1 file doesn't exist
+returns exit status 0 if all files have a corresponding valid \&.AppleDouble header or data fork, or 99 for bad command line options\&. Otherwise it returns the following error code relating to the last invalid file\&.
+.PP
+1 file doesn\'t exist
.PP
2 file is unreadable
.PP
.PP
9 bad magic in AppleDouble
.SH "SEE ALSO"
+.PP
\fBachfile\fR(1),
\fBafpd\fR(8)
-
-.TH afppasswd 1 "22 Aug 2004" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: afppasswd
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 22 Aug 2004
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "AFPPASSWD" "1" "22 Aug 2004" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
afppasswd \- netatalk password maintenance utility
-.SH SYNOPSIS
-\fBafppasswd\fR [\-acfn] [ \-p
-\fBpasswd\fR \fBfile\fR ] [ \-u
-\fBminimum\fR \fBuid\fR ]
-.SH DESCRIPTION
-afppasswd allows the maintenance of afppasswd
-files created by netatalk for use by the uams_randnum.so UAM (providing
-the "Randnum exchange" and "2\-Way Randnum exchange" User Authentication
-Modules).
-.PP
-afppasswd can either be called by root with
-parameters, or can be called by local system users with no parameters to
-change their AFP passwords.
-.RS
+.SH "SYNOPSIS"
+.HP \w'\fBafppasswd\fR\fB\fR\fB\fR\ 'u
+\fBafppasswd\fR\fB\fR\fB\fR [\-acfn] [\-p\ \fIpasswd\fR\ \fIfile\fR] [\-u\ \fIminimum\fR\ \fIuid\fR]
+.SH "DESCRIPTION"
+.PP
+\fBafppasswd\fR
+allows the maintenance of afppasswd files created by netatalk for use by the uams_randnum\&.so UAM (providing the "Randnum exchange" and "2\-Way Randnum exchange" User Authentication Modules)\&.
+.PP
+\fBafppasswd\fR
+can either be called by root with parameters, or can be called by local system users with no parameters to change their AFP passwords\&.
+.if n \{\
+.sp
+.\}
+.RS 4
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
\fBNote\fR
+.ps -1
+.br
.PP
-With this utility you can only change the passwords used by two
-specific UAMs. As they provide only weak password encryption, the use of
-the "Randnum exchange" and "2\-Way Randnum exchange" UAMs is deprecated
-unless one has to support very old AFP clients, that can not deal with
-the more secure "DHCAST128" UAM instead. Please compare with the [Cross reference to non\-existant ID \(lqauthentication\(rq] inside Netatalk's
-documentation.
+With this utility you can only change the passwords used by two specific UAMs\&. As they provide only weak password encryption, the use of the "Randnum exchange" and "2\-Way Randnum exchange" UAMs is deprecated unless one has to support very old AFP clients, that can not deal with the more secure "DHCAST128" UAM instead\&. Please compare with the
+Authentication chapter
+inside Netatalk\'s documentation\&.
+.sp .5v
.RE
-.SH EXAMPLE
-Local user changing their own password:
+.SH "EXAMPLE"
.PP
+Local user changing their own password:
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
example% \fBafppasswd\fR
Enter NEW AFP password: \fB(hidden)\fR
Enter NEW AFP password again: \fB(hidden)\fR
-afppasswd: updated password.
+afppasswd: updated password\&.
.fi
-.SH OPTIONS
-.TP
+.if n \{\
+.RE
+.\}
+.SH "OPTIONS"
+.PP
\fB\-a\fR
-Add a new user to the afppasswd
-file.
-.TP
+.RS 4
+Add a new user to the
+\fBafppasswd\fR
+file\&.
+.RE
+.PP
\fB\-c\fR
-Create and/or initialize afppasswd file or
-specific user.
-.TP
+.RS 4
+Create and/or initialize
+\fBafppasswd\fR
+file or specific user\&.
+.RE
+.PP
\fB\-f\fR
-Force the current action.
-.TP
+.RS 4
+Force the current action\&.
+.RE
+.PP
\fB\-p\fR\fI path\fR
-Path to afppasswd file.
-.TP
+.RS 4
+Path to
+\fBafppasswd\fR
+file\&.
+.RE
+.PP
\fB\-n\fR
-If cracklib support is built into \fInetatalk\fR this option will cause cracklib
-checking to be disabled, if the superuser does not want to have the
-password run against the cracklib dictionary.
-.TP
+.RS 4
+If cracklib support is built into
+\fBnetatalk\fR
+this option will cause cracklib checking to be disabled, if the superuser does not want to have the password run against the cracklib dictionary\&.
+.RE
+.PP
\fB\-u\fR\fI minimum uid\fR
-This is the minimum \fIuser id\fR
-(uid) that afppasswd will use when creating
-users.
+.RS 4
+This is the minimum
+\fIuser id\fR
+(uid) that
+\fBafppasswd\fR
+will use when creating users\&.
+.RE
.SH "SEE ALSO"
-\fBafpd\fR(8), \fBatalkd\fR(8).
-
+.PP
+\fBafpd\fR(8),
+\fBatalkd\fR(8)\&.
-.TH apple_cp 1 "22 Aug 2004" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: apple_cp
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 22 Aug 2004
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "APPLE_CP" "1" "22 Aug 2004" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
apple_cp \- Do an apple copy, copying file metadata and the resource fork as well
-.SH SYNOPSIS
-\fI:BINDIR:/apple_cp\fR \fISOURCE
-DEST\fR \fI:BINDIR:/apple_cp\fR \fISOURCE\fR... \fIDIRECTORY\fR
-.SH DESCRIPTION
-\fIapple_cp\fR is a perl script to copy
-SOURCE to DEST or multiple SOURCE(s) to DIRECTORY. It also copies the file
-specific metadata (including resource forks) to the .AppleDouble directory
-for DEST or DIRECTORY. If the .AppleDouble directory doesn't exist for
-DEST or DIRECTORY it will create it.
-.SH EXAMPLES
-\fI:BINDIR:/apple_cp\fR test.text
-/target/directory/
+.SH "SYNOPSIS"
.PP
-\fI:BINDIR:/apple_cp\fR test.text
-/target/directory/test2.text
+\fB:BINDIR:/apple_cp\fR\fB\fR
+\fISOURCE DEST\fR
+\fB:BINDIR:/apple_cp\fR
+\fISOURCE\fR\&.\&.\&.
+\fIDIRECTORY\fR
+.SH "DESCRIPTION"
.PP
-\fI:BINDIR:/apple_cp\fR test.text
-testing.text /target/directory/
+\fBapple_cp\fR
+is a perl script to copy SOURCE to DEST or multiple SOURCE(s) to DIRECTORY\&. It also copies the file specific metadata (including resource forks) to the \&.AppleDouble directory for DEST or DIRECTORY\&. If the \&.AppleDouble directory doesn\'t exist for DEST or DIRECTORY it will create it\&.
+.SH "EXAMPLES"
+.PP
+\fB:BINDIR:/apple_cp\fR
+test\&.text /target/directory/
+.PP
+\fB:BINDIR:/apple_cp\fR
+test\&.text /target/directory/test2\&.text
+.PP
+\fB:BINDIR:/apple_cp\fR
+test\&.text testing\&.text /target/directory/
.SH "REPORTING BUGS"
-Report bugs to the Netatalk\-devel list
-<netatalk\-devel@lists.sourceforge.net>.
+.PP
+Report bugs to the Netatalk\-devel list <netatalk\-devel@lists\&.sourceforge\&.net>\&.
.SH "SEE ALSO"
+.PP
\fBapple_mv\fR(1),
-\fBapple_rm\fR(1).
-
+\fBapple_rm\fR(1)\&.
-.TH apple_mv 1 "22 Aug 2004" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: apple_mv
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 22 Aug 2004
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "APPLE_MV" "1" "22 Aug 2004" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
apple_mv \- Do an apple move, moving metadata and the resource fork as well
-.SH SYNOPSIS
-\fI:BINDIR:/apple_mv\fR \fISOURCE
-DEST\fR \fI:BINDIR:/apple_mv\fR \fISOURCE\fR... \fIDIRECTORY\fR
-.SH DESCRIPTION
-\fIapple_mv\fR is a perl script to move
-SOURCE to DEST or multiple SOURCE(s) to DIRECTORY. It also moves the file
-specific metadata (including resource forks) to the .AppleDouble directory
-for DEST or DIRECTORY. If the .AppleDouble directory doesn't exist for
-DEST or DIRECTORY it will create it.
-.SH EXAMPLES
-\fI:BINDIR:/apple_mv\fR test.text
-/target/directory/
+.SH "SYNOPSIS"
.PP
-\fI:BINDIR:/apple_mv\fR test.text
-/target/directory/test2.text
+\fB:BINDIR:/apple_mv\fR\fB\fR
+\fISOURCE DEST\fR
+\fB:BINDIR:/apple_mv\fR
+\fISOURCE\fR\&.\&.\&.
+\fIDIRECTORY\fR
+.SH "DESCRIPTION"
.PP
-\fI:BINDIR:/apple_mv\fR test.text
-testing.text /target/directory/
+\fBapple_mv\fR
+is a perl script to move SOURCE to DEST or multiple SOURCE(s) to DIRECTORY\&. It also moves the file specific metadata (including resource forks) to the \&.AppleDouble directory for DEST or DIRECTORY\&. If the \&.AppleDouble directory doesn\'t exist for DEST or DIRECTORY it will create it\&.
+.SH "EXAMPLES"
+.PP
+\fB:BINDIR:/apple_mv\fR
+test\&.text /target/directory/
+.PP
+\fB:BINDIR:/apple_mv\fR
+test\&.text /target/directory/test2\&.text
+.PP
+\fB:BINDIR:/apple_mv\fR
+test\&.text testing\&.text /target/directory/
.SH "REPORTING BUGS"
-Report bugs to the Netatalk\-devel list
-<netatalk\-devel@lists.sourceforge.net>.
+.PP
+Report bugs to the Netatalk\-devel list <netatalk\-devel@lists\&.sourceforge\&.net>\&.
.SH "SEE ALSO"
+.PP
\fBapple_cp\fR(1),
-\fBapple_rm\fR(1).
-
+\fBapple_rm\fR(1)\&.
-.TH apple_rm 1 "22 Aug 2004" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: apple_rm
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 22 Aug 2004
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "APPLE_RM" "1" "22 Aug 2004" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
apple_rm \- Do an apple remove, remove metadata and resource fork as well
-.SH SYNOPSIS
-\fI:BINDIR:/apple_rm\fR \fIFILE\fR...
-.SH DESCRIPTION
-\fIapple_rm\fR is a perl script that
-removes FILE(s) as well as the .AppleDouble metadata file(s) that
-corresponds to FILE(s). These AppleDouble header files eventually also
-contain the resource fork if the files had one. \fIapple_rm\fR does not delete directories.
-.SH EXAMPLES
-\fI:BINDIR:/apple_rm\fR test.text
+.SH "SYNOPSIS"
.PP
-\fI:BINDIR:/apple_rm\fR test.text
-testing.text
+\fB:BINDIR:/apple_rm\fR\fB\fR
+\fIFILE\fR\&.\&.\&.
+.SH "DESCRIPTION"
+.PP
+\fBapple_rm\fR
+is a perl script that removes FILE(s) as well as the \&.AppleDouble metadata file(s) that corresponds to FILE(s)\&. These AppleDouble header files eventually also contain the resource fork if the files had one\&.
+\fBapple_rm\fR
+does not delete directories\&.
+.SH "EXAMPLES"
+.PP
+\fB:BINDIR:/apple_rm\fR
+test\&.text
+.PP
+\fB:BINDIR:/apple_rm\fR
+test\&.text testing\&.text
.SH "REPORTING BUGS"
-Report bugs to the Netatalk\-devel list
-<netatalk\-devel@lists.sourceforge.net>.
+.PP
+Report bugs to the Netatalk\-devel list <netatalk\-devel@lists\&.sourceforge\&.net>\&.
.SH "SEE ALSO"
-\fBapple_cp\fR(1), \fBapple_mv\fR(1).
-
+.PP
+\fBapple_cp\fR(1),
+\fBapple_mv\fR(1)\&.
-.TH asip\-status.pl 1 "22 Aug 2004" 2.0.0 Netatalk
-.SH NAME
-asip\-status.pl \- Queries AFP servers for their capabilities
-.SH SYNOPSIS
-\fI:BINDIR:/asip\-status.pl\fR ADDRESS\fI:PORT\fR...
-.SH DESCRIPTION
-\fIasip\-status.pl\fR is a perl script that
-sends a FPGetSrvrInfo request to an AFP server at ADDRESS:PORT and
-displays the results, namely "Machine type", the server's name, supported
-AFP versions, UAMs and AFP flags, the "server signature" and the network
-addresses, the server provides AFP services on.
+'\" t
+.\" Title: asip-status.pl
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 22 Aug 2004
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "ASIP\-STATUS\&.PL" "1" "22 Aug 2004" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+asip-status.pl \- Queries AFP servers for their capabilities
+.SH "SYNOPSIS"
.PP
-When you don't supply :PORT, then the default AFP port, 548, will be
-used.
-.SH EXAMPLES
+\fB:BINDIR:/asip\-status\&.pl\fR\fB\fR
+ADDRESS\fI:PORT\fR\&.\&.\&.
+.SH "DESCRIPTION"
+.PP
+\fBasip\-status\&.pl\fR
+is a perl script that sends a FPGetSrvrInfo request to an AFP server at ADDRESS:PORT and displays the results, namely "Machine type", the server\'s name, supported AFP versions, UAMs and AFP flags, the "server signature" and the network addresses, the server provides AFP services on\&.
+.PP
+When you don\'t supply :PORT, then the default AFP port, 548, will be used\&.
+.SH "EXAMPLES"
+.PP
+.if n \{\
+.RS 4
+.\}
.nf
-\fI:BINDIR:/asip\-status.pl\fR 192.168.21.2
-AFP reply from 192.168.21.2:548
+\fB:BINDIR:/asip\-status\&.pl\fR 192\&.168\&.21\&.2
+AFP reply from 192\&.168\&.21\&.2:548
Flags: 1 Cmd: 3 ID: 57005
Reply: DSIGetStatus
Request ID: 57005
Machine type: Macintosh
-AFP versions: AFPVersion 1.1,AFPVersion 2.0,AFPVersion 2.1,AFP2.2
+AFP versions: AFPVersion 1\&.1,AFPVersion 2\&.0,AFPVersion 2\&.1,AFP2\&.2
UAMs: Cleartxt passwrd,Randnum exchange,2\-Way Randnum exchange
Flags: SupportsCopyFile,SupportsChgPwd,SupportsServerMessages,
SupportsServerSignature,SupportsTCP/IP,SupportsSuperClient
Server name: PowerMac 9600/200
Signature:
-04 c1 6e 59 04 c1 6e 59 04 c1 6e 59 04 c1 6e 59 ..nY..nY..nY..nY
+04 c1 6e 59 04 c1 6e 59 04 c1 6e 59 04 c1 6e 59 \&.\&.nY\&.\&.nY\&.\&.nY\&.\&.nY
-Network address: 192.168.21.2:548 (tcp/ip address and port)
-Network address: 10.20 (ddp address)
+Network address: 192\&.168\&.21\&.2:548 (tcp/ip address and port)
+Network address: 10\&.20 (ddp address)
.fi
+.if n \{\
+.RE
+.\}
.PP
+.if n \{\
+.RS 4
+.\}
.nf
-\fI:BINDIR:/asip\-status.pl\fR 192.168.21.1:10548
-AFP reply from 192.168.21.1:10548
+\fB:BINDIR:/asip\-status\&.pl\fR 192\&.168\&.21\&.1:10548
+AFP reply from 192\&.168\&.21\&.1:10548
Flags: 1 Cmd: 3 ID: 57005
Reply: DSIGetStatus
Request ID: 57005
Machine type: Netatalk
-AFP versions: AFPVersion 1.1,AFPVersion 2.0,AFPVersion 2.1,AFP2.2,AFPX03,
-AFP3.1
+AFP versions: AFPVersion 1\&.1,AFPVersion 2\&.0,AFPVersion 2\&.1,AFP2\&.2,AFPX03,
+AFP3\&.1
UAMs: Cleartxt passwrd,Randnum exchange,2\-Way Randnum exchange,DHCAST128
Flags: SupportsCopyFile,SupportsServerMessages,SupportsServerSignature,
SupportsTCP/IP,SupportsSrvrNotifications,SupportsOpenDirectory,
SupportsUTF8Servername,SupportsSuperClient
Server name: Fire V480
Signature:
-83 29 cc 60 83 29 cc 60 83 29 cc 60 83 29 cc 60 .).`.).`.).`.).`
+83 29 cc 60 83 29 cc 60 83 29 cc 60 83 29 cc 60 \&.)\&.`\&.)\&.`\&.)\&.`\&.)\&.`
-Network address: 192.168.21.1:10548 (TCP/IP address and port)
-Network address: 65282.142 (ddp address)
+Network address: 192\&.168\&.21\&.1:10548 (TCP/IP address and port)
+Network address: 65282\&.142 (ddp address)
UTF8 Servername: Fire V480
.fi
+.if n \{\
+.RE
+.\}
.SH "REPORTING BUGS"
-Report bugs to the Netatalk\-devel list
-<netatalk\-devel@lists.sourceforge.net>.
-
+.PP
+Report bugs to the Netatalk\-devel list <netatalk\-devel@lists\&.sourceforge\&.net>\&.
.\" Title: dbd
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
-.\" Date: 26 May 2009
-.\" Manual: Netatalk
-.\" Source: Netatalk
+.\" Date: 23 Dec 2009
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
.\" Language: English
.\"
-.TH "DBD" "1" "26 May 2009" "2.1dev" "Netatalk"
+.TH "DBD" "1" "23 Dec 2009" "Netatalk 2.1beta" "Netatalk 2.1beta"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
dbd \- CNID database maintanance
.SH "SYNOPSIS"
.HP \w'\fBdbd\fR\fB\fR\ 'u
-\fBdbd\fR\fB\fR [\-evx] \-d\ [\-i] | \-s | \-r\ [\-f] \fIvolumepath\fR
+\fBdbd\fR\fB\fR [\-evx] {\-d\ [\-i] | \-s\ [n] | \-r\ [\-f] | \-u} \fIvolumepath\fR
.SH "DESCRIPTION"
.PP
\fBdbd\fR
Check for orphaned CNIDs in database (requires
\fB\-e\fR)
.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Open and close adouble files
+.RE
+.RS 4
+.PP
+Options:
+.RS 4
+\fB\-n\fR
+Don\'t open CNID database, skip CNID checks, only traverse filesystem
+.RE
.RE
.PP
\-r
.RS 4
Rebuild volume\&. With
\fB\-f\fR
-wipe database and rebuild from CNIIDs stored in AppleDouble files, only available for volumes with \'cachecnid\' option\&. Implies
-\fB\-e\fR\&.
+wipe database and rebuild from CNIIDs stored in AppleDouble files\&.
.sp
.RS 4
.ie n \{\
Delete orphaned CNIDs in database (requires
\fB\-e\fR)
.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Open and close adouble files
+.RE
+.RS 4
+.PP
+Options:
+.RS 4
+\fB\-f\fR
+Wipe database and rebuild from IDs stored in AppleDouble files, only available for volumes without
+\fBnocnidcache\fR
+option\&. Implies
+\fB\-e\fR\&.
+.RE
+.RE
+.PP
+\-u
+.RS 4
+Prepare upgrade:
+.sp
+Before installing an upgraded version of Netatalk that is linked against a newer BerkeleyDB lib, run `dbd \-u \&.\&.\&.` from the OLD Netatalk pior to upgrading on all volumes\&. This removes the BerkleyDB environment\&. On exit cnid_dbd does this automatically, so normally calling dbd \-u should not be necessary !
.RE
.SH "OPTIONS"
.PP
.RE
.SH "WARNING"
.PP
-If you want/need to run an \-r \-f rebuild after adding \'cachecnid\' to a volume configuration, you must run a rebuild with \-r alone at first in order to sync all existing CNIDs from the db to the AppleDouble files!
+In order to be able to run
+\fB\-rf\fR
+reconstructing the CNIDs in the database from the
+\fIAppleDouble\fR
+files, make sure you\'ve run a
+\fB\-r\fR
+rebuild sometimes before, where the CNIDs then would have been synched between database and
+\fIAppleDouble\fR
+files\&.
+.PP
+Also be careful about the option
+\fBnocnidcache\fR\&. Avoid this option if at all possible, because if prevents you from being able to use
+\fB\-f\fR\&.
.SH "CNID BACKGROUND"
.PP
-The CNID backends maintains name to ID mappings\&. If you change a filename outside afpd(8) (shell, samba), the CNID db will not know and doesn\'t reflect that change\&. Netatalk tries to recover from such inconsistencies as gracefully as possible\&. The mechanisms to resolve such inconsistencies may fail sometimes, though, as this is not an easy task to accomplish\&. E\&.g\&. if several names in the path to the file or directory have changed, things may go wrong\&.
+The CNID backends maintains name to ID mappings\&. If you change a filename outside afpd(8) (shell, samba), the CNID db will not know and not reflect that change\&. Netatalk tries to recover from such inconsistencies as gracefully as possible\&. The mechanisms to resolve such inconsistencies may fail sometimes, though, as this is not an easy task to accomplish\&. E\&.g\&. if several names in the path to the file or directory have changed, things may go wrong\&.
.PP
If you change a lot of filenames at once, chances are higher that the afpds fallback mechanisms fail, i\&.e\&. files will be assigned new IDs, even though the file hasn\'t changed\&.
.SH "SEE ALSO"
-.TH getzones 1 "17 Dec 1991" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: getzones
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 17 Dec 1991
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "GETZONES" "1" "17 Dec 1991" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
getzones \- list AppleTalk zone names
-.SH SYNOPSIS
-\fBgetzones\fR [\-m | \-l] [\fBaddress\fR]
-.SH DESCRIPTION
-\fIGetzones\fR is used to obtain a list of
-AppleTalk zone names using the Zone Information Protocol (ZIP). It sends a
-GetZoneList request to an AppleTalk router. By default, it sends the
-request to the locally running \fBatalkd\fR(8).
-.SH OPTIONS
-.TP
+.SH "SYNOPSIS"
+.HP \w'\fBgetzones\fR\fB\fR\ 'u
+\fBgetzones\fR\fB\fR [\-m | \-l] [\fIaddress\fR]
+.SH "DESCRIPTION"
+.PP
+\fBGetzones\fR
+is used to obtain a list of AppleTalk zone names using the Zone Information Protocol (ZIP)\&. It sends a GetZoneList request to an AppleTalk router\&. By default, it sends the request to the locally running
+\fBatalkd\fR(8)\&.
+.SH "OPTIONS"
+.PP
\fB\-m\fR
-List the name of the local zone only; this is accomplished by
-sending a ZIP GetMyZone request.
-.TP
+.RS 4
+List the name of the local zone only; this is accomplished by sending a ZIP GetMyZone request\&.
+.RE
+.PP
\fB\-l\fR
-List the local zones; this is accomplished by sending a
-GetLocalZones request.
-.TP
+.RS 4
+List the local zones; this is accomplished by sending a GetLocalZones request\&.
+.RE
+.PP
\fIaddress\fR
-Contact the AppleTalk router at \fIaddress.\fR
-\fIaddress\fR is parsed by
-\fBatalk_aton\fR(3).
+.RS 4
+Contact the AppleTalk router at
+\fIaddress\&.\fR
+\fIaddress\fR
+is parsed by
+\fBatalk_aton\fR(3)\&.
+.RE
.SH "SEE ALSO"
+.PP
\fBatalk_aton\fR(3),
-\fBatalkd\fR(8).
-
+\fBatalkd\fR(8)\&.
-.TH megatron 1 "8 Jan 1992" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: megatron
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 8 Jan 1992
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "MEGATRON" "1" "8 Jan 1992" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
megatron, unhex, unbin, unsingle, hqx2bin, single2bin, macbinary \- Macintosh file format transformer
-.SH SYNOPSIS
-\fBmegatron\fR [\fBsourcefile\fR]\&...
-.sp 1
-\fBunbin\fR [\fBsourcefile\fR]\&...
-.sp 1
-\fBunhex\fR [\fBsourcefile\fR]\&...
-.sp 1
-\fBunsingle\fR [\fBsourcefile\fR]\&...
-.sp 1
-\fBhqx2bin\fR [\fBsourcefile\fR]\&...
-.sp 1
-\fBsingle2bin\fR [\fBsourcefile\fR]\&...
-.sp 1
-\fBmacbinary\fR [\fBsourcefile\fR]\&...
-.SH DESCRIPTION
-megatron is used to transform files from BinHex,
-MacBinary, AppleSingle, or \fBnetatalk\fR style
-AppleDouble formats into MacBinary or \fInetatalk\fR
-style AppleDouble formats. The \fInetatalk\fR
-style AppleDouble format is the file format used by \fIafpd,\fR
-the \fInetatalk\fR Apple Filing Protocol
-(AppleShare) server. BinHex, MacBinary, and AppleSingle are commonly used
-formats for transferring Macintosh files between machines via email or
-file transfer protocols. megatron uses its name to
-determine what type of tranformation is being asked of it.
+.SH "SYNOPSIS"
+.HP \w'\fBmegatron\fR\fB\fR\fBunbin\fR\fB\fR\fBunhex\fR\fB\fR\fBunsingle\fR\fB\fR\fBhqx2bin\fR\fB\fR\fBsingle2bin\fR\fB\fR\fBmacbinary\fR\fB\fR\ 'u
+\fBmegatron\fR\fB\fR [\fIsourcefile\fR...]
+.br
+\fBunbin\fR\fB\fR [\fIsourcefile\fR...]
+.br
+\fBunhex\fR\fB\fR [\fIsourcefile\fR...]
+.br
+\fBunsingle\fR\fB\fR [\fIsourcefile\fR...]
+.br
+\fBhqx2bin\fR\fB\fR [\fIsourcefile\fR...]
+.br
+\fBsingle2bin\fR\fB\fR [\fIsourcefile\fR...]
+.br
+\fBmacbinary\fR\fB\fR [\fIsourcefile\fR...]
+.SH "DESCRIPTION"
.PP
-If megatron is called as unhex
-, unbin or unsingle, it tries to
-convert file(s) from BinHex, MacBinary, or AppleSingle into AppleDouble
-format. BinHex is the format most often used to send Macintosh files by
-e\-mail. Usually these files have an extension of ".hqx". MacBinary
-is the format most often used by terminal emulators "on the fly"
-when transferring Macintosh files in binary mode. MacBinary files often
-have an extension of ".bin". Some Macintosh LAN\-based email
-packages use uuencoded AppleSingle format to "attach" or
-"enclose" files in email. AppleSingle files don't have a
-standard filename extension.
+\fBmegatron\fR
+is used to transform files from BinHex, MacBinary, AppleSingle, or
+\fBnetatalk\fR
+style AppleDouble formats into MacBinary or
+\fBnetatalk\fR
+style AppleDouble formats\&. The
+\fBnetatalk\fR
+style AppleDouble format is the file format used by
+\fBafpd,\fR
+the
+\fBnetatalk\fR
+Apple Filing Protocol (AppleShare) server\&. BinHex, MacBinary, and AppleSingle are commonly used formats for transferring Macintosh files between machines via email or file transfer protocols\&.
+\fBmegatron\fR
+uses its name to determine what type of tranformation is being asked of it\&.
.PP
-If megatron is called as hqx2bin,
-single2bin, or macbinary, it will
-try to convert the file(s) from BinHex, AppleSingle, or AppleDouble into
-MacBinary. This last translation may be useful in moving Macintosh files
-from your afpd server to some other machine when you
-can't copy them from the server using a Macintosh for some reason.
+If
+\fBmegatron\fR
+is called as
+\fBunhex\fR
+,
+\fBunbin\fR
+or
+\fBunsingle\fR, it tries to convert file(s) from BinHex, MacBinary, or AppleSingle into AppleDouble format\&. BinHex is the format most often used to send Macintosh files by e\-mail\&. Usually these files have an extension of "\&.hqx"\&. MacBinary is the format most often used by terminal emulators "on the fly" when transferring Macintosh files in binary mode\&. MacBinary files often have an extension of "\&.bin"\&. Some Macintosh LAN\-based email packages use uuencoded AppleSingle format to "attach" or "enclose" files in email\&. AppleSingle files don\'t have a standard filename extension\&.
.PP
-If megatron is called with any other name, it
-uses the default translation, namely unhex.
+If
+\fBmegatron\fR
+is called as
+\fBhqx2bin\fR,
+\fBsingle2bin\fR, or
+\fBmacbinary\fR, it will try to convert the file(s) from BinHex, AppleSingle, or AppleDouble into MacBinary\&. This last translation may be useful in moving Macintosh files from your
+\fBafpd\fR
+server to some other machine when you can\'t copy them from the server using a Macintosh for some reason\&.
.PP
-If no source file is given, or if \fIsourcefile\fR
-is `\fB\-\fR', and if the
-conversion is from a BinHex or MacBinary file, megatron
-will read from standard input.
+If
+\fBmegatron\fR
+is called with any other name, it uses the default translation, namely
+\fBunhex\fR\&.
.PP
-The filename used to store any output file is the filename that is
-encoded in the source file. MacBinary files are created with a
-".bin" extension. In the case of conflicts, the old file is
-overwritten!
+If no source file is given, or if
+\fIsourcefile\fR
+is `\fB\-\fR\', and if the conversion is from a BinHex or MacBinary file,
+\fBmegatron\fR
+will read from standard input\&.
+.PP
+The filename used to store any output file is the filename that is encoded in the source file\&. MacBinary files are created with a "\&.bin" extension\&. In the case of conflicts, the old file is overwritten!
.SH "SEE ALSO"
+.PP
\fBafpd\fR(8)
-
-.TH nbp 1 "24 June 2004" 2.0.0 Netatalk
-.SH NAME
-nbplkup, nbprgstr, nbpunrgstr \- access NBP database
-.SH SYNOPSIS
-\fBnbplkup \fR[\-r \fBmaxresponses\fR] [\-A \fBaddress\fR] [\-m \fBmaccodepage\fR] \fBnbpname\fR
+'\" t
+.\" Title: nbp
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 24 June 2004
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "NBP" "1" "24 June 2004" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+nbp, nbplkup, nbprgstr, nbpunrgstr \- access NBP database
+.SH "SYNOPSIS"
+.HP \w'\fBnbplkup\fR\fB\fR\fB\fR\fB\ \fR\ 'u
+\fBnbplkup\fR\fB\fR\fB\fR\fB \fR [\-r\ \fImaxresponses\fR] [\-A\ \fIaddress\fR] [\-m\ \fImaccodepage\fR] \fInbpname\fR
+.HP \w'\fBnbprgstr\fR\fB\fR\fB\ \fR\ 'u
+\fBnbprgstr\fR\fB\fR\fB \fR [\-A\ \fIaddress\fR] [\-p\ \fIport\fR] [\-m\ \fImaccodepage\fR] \fInbpname\fR
+.HP \w'\fBnbpunrgstr\fR\fB\fR\fB\ \fR\ 'u
+\fBnbpunrgstr\fR\fB\fR\fB \fR [\-A\ \fIaddress\fR] [\-m\ \fImaccodepage\fR] \fInbpname\fR
+.SH "DESCRIPTION"
.PP
-\fBnbprgstr \fR[\-A \fBaddress\fR] [\-p \fBport\fR] [\-m \fBmaccodepage\fR] \fBnbpname\fR
+\fBnbprgstr\fR
+registers
+\fInbpname\fR
+with
+\fBatalkd\fR(8), at the given
+\fIport\fR\&.
+\fBnbpunrgstr\fR
+informs
+\fBatalkd\fR
+that
+\fInbpname\fR
+is no longer to be advertised\&.
.PP
-\fBnbpunrgstr \fR[\-A \fBaddress\fR] [\-m \fBmaccodepage\fR] \fBnbpname\fR
-.SH DESCRIPTION
-nbprgstr registers \fInbpname\fR
-with \fBatalkd\fR(8),
-at the given \fIport\fR. nbpunrgstr
-informs \fIatalkd\fR that
-\fInbpname\fR is no longer to be advertised.
-.PP
-nbplkup displays up to
-\fImaxresponses\fR (default 1000) entities registered
-on the AppleTalk internet. \fInbpname\fR
-is parsed by \fBnbp_name\fR(3).
-An `\fI=\fR' for the \fIobject\fR
-or \fItype\fR matches anything, and an `\fI*\fR' for \fIzone\fR means
-the local zone. The default values are taken from the \fINBPLKUP\fR
-environment variable, parsed as an \fInbpname\fR.
+\fBnbplkup\fR
+displays up to
+\fImaxresponses\fR
+(default 1000) entities registered on the AppleTalk internet\&.
+\fI\fInbpname\fR\fR
+is parsed by
+\fBnbp_name\fR(3)\&. An `\fB=\fR\' for the
+\fIobject\fR
+or
+\fItype\fR
+matches anything, and an `\fB*\fR\' for
+\fIzone\fR
+means the local zone\&. The default values are taken from the
+\fBNBPLKUP\fR
+environment variable, parsed as an
+\fInbpname\fR\&.
.SH "ENVIRONMENT VARIABLES"
-.TP
+.PP
NBPLKUP
+.RS 4
default nbpname for nbplkup
-.TP
+.RE
+.PP
ATALK_MAC_CHARSET
+.RS 4
the codepage used by the clients on the Appletalk network
-.TP
+.RE
+.PP
ATALK_UNIX_CHARSET
-the codepage used to display extended characters on this
-shell.
-.SH EXAMPLE
-Find all devices of type \fILaserWriter\fR
-in the local zone.
+.RS 4
+the codepage used to display extended characters on this shell\&.
+.RE
+.SH "EXAMPLE"
.PP
+Find all devices of type
+\fBLaserWriter\fR
+in the local zone\&.
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
example% \fBnbplkup :LaserWriter\fR
- Petoskey:LaserWriter 7942.129:218
- Gloucester:LaserWriter 8200.188:186
- Rahway:LaserWriter 7942.2:138
- 517 Center:LaserWriter 7942.2:132
- ionia:LaserWriter 7942.2:136
- Evil DEC from Hell:LaserWriter 7942.2:130
- Hamtramck:LaserWriter 7942.2:134
- Iron Mountain :LaserWriter 7942.128:250
+ Petoskey:LaserWriter 7942\&.129:218
+ Gloucester:LaserWriter 8200\&.188:186
+ Rahway:LaserWriter 7942\&.2:138
+ 517 Center:LaserWriter 7942\&.2:132
+ ionia:LaserWriter 7942\&.2:136
+ Evil DEC from Hell:LaserWriter 7942\&.2:130
+ Hamtramck:LaserWriter 7942\&.2:134
+ Iron Mountain :LaserWriter 7942\&.128:250
example%
.fi
+.if n \{\
+.RE
+.\}
.SH "SEE ALSO"
+.PP
\fBnbp_name\fR(3),
-\fBatalkd\fR(8).
-
+\fBatalkd\fR(8)\&.
-.TH netatalk\-config 1 "09 June 2001" 2.0.0 Netatalk
-.SH NAME
-netatalk\-config \- script to get information about the installed version of netatalk
-.SH SYNOPSIS
-\fBnetatalk\-config\fR [ \-\-prefix [\fB=DIR\fR]] [ \-\-exec_prefix [\fB=DIR\fR]] [\-\-help] [\-\-version] [\-\-libs] [\-\-libs\-dirs] [\-\-libs\-names] [\-\-cflags] [\-\-macros]
-.SH DESCRIPTION
-netatalk\-config is a tool that is used to
-determine the compiler and linker flags that should be used
-to compile and link programs that use the \fInetatalk\fR
-run\-time libraries.
-.SH OPTIONS
-netatalk\-config accepts the following options:
-.TP
+'\" t
+.\" Title: netatalk-config
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 09 June 2001
+.\" Manual: The Netatalk Project
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "NETATALK\-CONFIG" "1" "09 June 2001" "Netatalk 2.1" "The Netatalk Project"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+netatalk-config \- script to get information about the installed version of netatalk
+.SH "SYNOPSIS"
+.HP \w'\fBnetatalk\-config\fR\fB\fR\ 'u
+\fBnetatalk\-config\fR\fB\fR [\-\-prefix\ [\fI=DIR\fR]] [\-\-exec_prefix\ [\fI=DIR\fR]] [\-\-help] [\-\-version] [\-\-libs] [\-\-libs\-dirs] [\-\-libs\-names] [\-\-cflags] [\-\-macros]
+.SH "DESCRIPTION"
+.PP
+\fBnetatalk\-config\fR
+is a tool that is used to determine the compiler and linker flags that should be used to compile and link programs that use the
+\fInetatalk\fR
+run\-time libraries\&.
+.SH "OPTIONS"
+.PP
+\fBnetatalk\-config\fR
+accepts the following options:
+.PP
\fB\-\-help\fR
-Print a short help for this command and exit.
-.TP
+.RS 4
+Print a short help for this command and exit\&.
+.RE
+.PP
\fB\-\-version\fR
-Print the currently installed version of \fInetatalk\fR
-on the standard output.
-.TP
+.RS 4
+Print the currently installed version of
+\fInetatalk\fR
+on the standard output\&.
+.RE
+.PP
\fB\-\-libs\fR
+.RS 4
Print the linker flags that are necessary to link against the
-\fInetatalk\fR run\-time libraries.
-.TP
+\fInetatalk\fR
+run\-time libraries\&.
+.RE
+.PP
\fB\-\-libs\-dirs\fR
-Print only the \-l/\-R part of \-\-libs.
-.TP
+.RS 4
+Print only the \-l/\-R part of \-\-libs\&.
+.RE
+.PP
\fB\-\-libs\-names\fR
-Print only the \-l part of \-\-libs.
-.TP
+.RS 4
+Print only the \-l part of \-\-libs\&.
+.RE
+.PP
\fB\-\-cflags\fR
-Print the compiler flags that are necessary to compile a
-program linked against the \fInetatalk\fR
-run\-time libraries.
-.TP
+.RS 4
+Print the compiler flags that are necessary to compile a program linked against the
+\fInetatalk\fR
+run\-time libraries\&.
+.RE
+.PP
\fB\-\-macros\fR
-Print the \fInetatalk\fR m4
-directory.
-.TP
+.RS 4
+Print the
+\fInetatalk\fR
+m4 directory\&.
+.RE
+.PP
\fB\-\-prefix=PREFIX\fR
-If specified, use PREFIX instead of the installation prefix
-that \fInetatalk\fR was built with when
-computing the output for the \-\-cflags and \-\-libs options. This
-option is also used for the exec prefix if \-\-exec\-prefix was not
-specified. This option must be specified before any \-\-libs or
-\-\-cflags options.
-.TP
-\fB\-\-exec\\_prefix=PREFIX\fR
-If specified, use PREFIX instead of the installation exec
-prefix that \fInetatalk\fR was built with
-when computing the output for the \-\-cflags and \-\-libs options. This
-option must be specified before any \-\-libs or \-\-cflags options.
-.SH COPYRIGHT
+.RS 4
+If specified, use PREFIX instead of the installation prefix that
+\fInetatalk\fR
+was built with when computing the output for the \-\-cflags and \-\-libs options\&. This option is also used for the exec prefix if \-\-exec\-prefix was not specified\&. This option must be specified before any \-\-libs or \-\-cflags options\&.
+.RE
+.PP
+\fB\-\-exec\e_prefix=PREFIX\fR
+.RS 4
+If specified, use PREFIX instead of the installation exec prefix that
+\fInetatalk\fR
+was built with when computing the output for the \-\-cflags and \-\-libs options\&. This option must be specified before any \-\-libs or \-\-cflags options\&.
+.RE
+.SH "COPYRIGHT"
+.PP
Copyright \(co 1998 Owen Taylor
.PP
-Permission to use, copy, modify, and distribute this software and
-its documentation for any purpose and without fee is hereby granted,
-provided that the above copyright notice appear in all copies and that
-both that copyright notice and this permission notice appear in supporting
-documentation.
+Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation\&.
.PP
-Man page adapted for netatalk\-config by Sebastian
-Rittau in 2001.
-
+Man page adapted for
+\fBnetatalk\-config\fR
+by Sebastian Rittau in 2001\&.
-.TH pap 1 "6 May 2002" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: pap
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 6 May 2002
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "PAP" "1" "6 May 2002" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
pap \- client interface to remote printers using Printer Access Protocol
-.SH SYNOPSIS
-\fBpap\fR [ \-A \fBaddress\fR ] [\-c] [\-d] [\-e] [\-E] [ \-p \fBnbpname\fR ] [ \-s \fBstatusfile\fR ] [\-w] [\-W] [\fBFILES\fR]
-.SH DESCRIPTION
-pap is used to connect and send files to an
-AppleTalk connected printer using the Apple Printer Access Protocol (PAP).
-When pap starts execution, it tries to open a session
-with the printer using PAP, and then downloads the \fIfiles\fR
-to the printer.
+.SH "SYNOPSIS"
+.HP \w'\fBpap\fR\fB\fR\ 'u
+\fBpap\fR\fB\fR [\-A\ \fIaddress\fR] [\-c] [\-d] [\-e] [\-E] [\-p\ \fInbpname\fR] [\-s\ \fIstatusfile\fR] [\-w] [\-W] [\fIFILES\fR]
+.SH "DESCRIPTION"
.PP
-If no \fIfiles\fR are given on the command
-line, pap begins reading from standard input.
+\fBpap\fR
+is used to connect and send files to an AppleTalk connected printer using the Apple Printer Access Protocol (PAP)\&. When
+\fBpap\fR
+starts execution, it tries to open a session with the printer using PAP, and then downloads the
+\fIfiles\fR
+to the printer\&.
.PP
-If no printer is specified on the command line, pap
-looks for a file called .paprc in the current working
-directory and reads it to obtain the \fInbpname\fR
-of a printer. Blank lines and lines that begin with a `\fI#\fR'
-are ignored. \fItype\fR and \fIzone\fR
-default to \fILaserWriter\fR and the zone of the
-local host, respectively.
+If no
+\fIfiles\fR
+are given on the command line,
+\fBpap\fR
+begins reading from standard input\&.
.PP
-Note that pap is designed to be useful as a
-communication filter for sending \fBlpd\fR(8)
-spooled print jobs to AppleTalk connected printers. See
+If no printer is specified on the command line,
+\fBpap\fR
+looks for a file called
+\fB\&.paprc\fR
+in the current working directory and reads it to obtain the
+\fInbpname\fR
+of a printer\&. Blank lines and lines that begin with a `\fB#\fR\' are ignored\&.
+\fItype\fR
+and
+\fIzone\fR
+default to
+\fBLaserWriter\fR
+and the zone of the local host, respectively\&.
+.PP
+Note that
+\fBpap\fR
+is designed to be useful as a communication filter for sending
+\fBlpd\fR(8)
+spooled print jobs to AppleTalk connected printers\&. See
\fBpsf\fR(8)
-for hints on how to use it this way.
-.SH OPTIONS
-.TP
+for hints on how to use it this way\&.
+.SH "OPTIONS"
+.PP
\fB\-A \fR\fIaddress\fR
-Connect to the printer with Appletalk address \fIaddress\fR and do not consult the
-\&.paprc file to find a printer name. See
+.RS 4
+Connect to the printer with Appletalk address
+\fIaddress\fR
+and do not consult the
+\fB\&.paprc\fR
+file to find a printer name\&. See
\fBatalk_aton\fR(3)
-for the syntax of \fIaddress\fR.
-.TP
+for the syntax of
+\fIaddress\fR\&.
+.RE
+.PP
\fB\-c\fR
-Take cuts. The PAP protocol specified a simple queuing
-procedure, such that the clients tell the printer how long they have
-been waiting to print. This option causes pap to
-lie about how long it has been waiting.
-.TP
+.RS 4
+Take cuts\&. The PAP protocol specified a simple queuing procedure, such that the clients tell the printer how long they have been waiting to print\&. This option causes
+\fBpap\fR
+to lie about how long it has been waiting\&.
+.RE
+.PP
\fB\-d\fR
-Enable debug output.
-.TP
+.RS 4
+Enable debug output\&.
+.RE
+.PP
\fB\-e\fR
-Send any message from the printer to stderr instead of stdout.
+.RS 4
+Send any message from the printer to stderr instead of stdout\&.
\fBpsf\fR(8)
-invokes pap with this option.
-.TP
+invokes
+\fBpap\fR
+with this option\&.
+.RE
+.PP
\fB\-E\fR
-Don't wait for EOF from the printer. This option is useful
-for printers which don't implement PAP correctly. In a correct
-implementation, the client side should wait for the printer to
-return EOF before closing the connection. Some clients don't
-wait, and hence some printers have related bugs in their
-implementation.
-.TP
+.RS 4
+Don\'t wait for EOF from the printer\&. This option is useful for printers which don\'t implement PAP correctly\&. In a correct implementation, the client side should wait for the printer to return EOF before closing the connection\&. Some clients don\'t wait, and hence some printers have related bugs in their implementation\&.
+.RE
+.PP
\fB\-p\fR \fInbpname\fR
-Connect to the printer named \fInbpname\fR
-and do not consult the .paprc file to find a
-printer name. See \fBnbp_name\fR(3)
-for the syntax of \fInbpname\fR.
-.TP
+.RS 4
+Connect to the printer named
+\fInbpname\fR
+and do not consult the
+\fB\&.paprc\fR
+file to find a printer name\&. See
+\fBnbp_name\fR(3)
+for the syntax of
+\fInbpname\fR\&.
+.RE
+.PP
\fB\-s\fR \fIstatusfile\fR
-Update the file called \fIstatusfile\fR
-to contain the most recent status message from the printer.
-pap gets the status from the printer when it is
-waiting for the printer to process input. The \fIstatusfile\fR
-will contain a single line terminated with a newline. This is useful
-when pap is invoked by
+.RS 4
+Update the file called
+\fIstatusfile\fR
+to contain the most recent status message from the printer\&.
+\fBpap\fR
+gets the status from the printer when it is waiting for the printer to process input\&. The
+\fIstatusfile\fR
+will contain a single line terminated with a newline\&. This is useful when
+\fBpap\fR
+is invoked by
\fBpsf\fR(8)
-within \fIlpd\fR's spool directory.
-.TP
+within
+\fBlpd\fR\'s spool directory\&.
+.RE
+.PP
\fB\-w\fR
-Wait for the printer status to contain the word
-"waiting" before sending the job. This is to defeat
-printer\-side spool available on HP IV and V printers.
-.TP
+.RS 4
+Wait for the printer status to contain the word "waiting" before sending the job\&. This is to defeat printer\-side spool available on HP IV and V printers\&.
+.RE
+.PP
\fB\-W\fR
-Wait for the printer status to contain the word "idle"
-before sending the job. This is to defeat printer\-side spool
-available on HP IV and V printers.
-.SH FILES
-.TP
-\&.paprc
-file read to obtain printer name if not specified on command
-line
+.RS 4
+Wait for the printer status to contain the word "idle" before sending the job\&. This is to defeat printer\-side spool available on HP IV and V printers\&.
+.RE
+.SH "FILES"
+.PP
+\fB\&.paprc\fR
+.RS 4
+file read to obtain printer name if not specified on command line
+.RE
.SH "SEE ALSO"
+.PP
\fBnbp_name\fR(3),
\fBatalk_aton\fR(3),
\fBlpd\fR(8),
-\fBpsf\fR(8).
-
+\fBpsf\fR(8)\&.
-.TH psorder 1 "17 Dec 1991" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: psorder
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 17 Dec 1991
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "PSORDER" "1" "17 Dec 1991" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
psorder \- PostScript pageorder filter
-.SH SYNOPSIS
-\fBpsorder\fR [\-duf] \fBsourcefile\fR
-.SH DESCRIPTION
-psorder is a filter that re\-orders the pages of a
-PostScript document. The result is written to the standard output. By
-default, documents are processed into ascending order (the lowest numbered
-page is printed first). Some PostScript documents specify that the order
-of their pages should never be changed; the default action of
-psorder is to follow this specification.
+.SH "SYNOPSIS"
+.HP \w'\fBpsorder\fR\fB\fR\ 'u
+\fBpsorder\fR\fB\fR [\-duf] \fIsourcefile\fR
+.SH "DESCRIPTION"
+.PP
+\fBpsorder\fR
+is a filter that re\-orders the pages of a PostScript document\&. The result is written to the standard output\&. By default, documents are processed into ascending order (the lowest numbered page is printed first)\&. Some PostScript documents specify that the order of their pages should never be changed; the default action of
+\fBpsorder\fR
+is to follow this specification\&.
+.PP
+If no source file is given, or if
+\fIsourcefile\fR
+is `\fB\-\fR\',
+\fBpsorder\fR
+reads from the standard input file\&.
+.SH "OPTIONS"
.PP
-If no source file is given, or if \fIsourcefile\fR
-is `\fI\-\fR', psorder
-reads from the standard input file.
-.SH OPTIONS
-.TP
\fB\-d\fR
-Re\-order the pages of the document in downward or descending
-order. This is typically used to change the order of a document to
-be printed by a printer that stacks pages face\-up, such as an Apple
-LaserWriter or LaserWriter Plus.
-.TP
+.RS 4
+Re\-order the pages of the document in downward or descending order\&. This is typically used to change the order of a document to be printed by a printer that stacks pages face\-up, such as an Apple LaserWriter or LaserWriter Plus\&.
+.RE
+.PP
\fB\-u\fR
-Specifies forward order, and is the default. It is used to try
-and ensure the correct ordering when a document will be printed by a
-printer that stacks the pages face\-down.
-.TP
+.RS 4
+Specifies forward order, and is the default\&. It is used to try and ensure the correct ordering when a document will be printed by a printer that stacks the pages face\-down\&.
+.RE
+.PP
\fB\-f\fR
-Force psorder to re\-order the pages, even
-if the document claims that its page order is not to be trifled
-with. This option should only be used experimentally, as it may
-cause documents to print incorrectly.
+.RS 4
+Force
+\fBpsorder\fR
+to re\-order the pages, even if the document claims that its page order is not to be trifled with\&. This option should only be used experimentally, as it may cause documents to print incorrectly\&.
+.RE
.SH "SEE ALSO"
+.PP
\fBpsf\fR(8),
-\fBlpr\fR(1).
-
+\fBlpr\fR(1)\&.
-.TH uniconv 1 "24 Jun 2004" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: uniconv
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 24 Jun 2004
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "UNICONV" "1" "24 Jun 2004" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
uniconv \- convert Netatalk volume encoding
-.SH SYNOPSIS
-\fBuniconv\fR [\-ndv] \-c \fBcnidbackend\fR \-f \fBfromcode\fR \-t \fBtocode\fR [\-m \fBmaccode\fR] \fBvolumepath\fR
-.SH DESCRIPTION
-uniconv converts the volume encoding of
-\fIvolumepath\fR from the \fIfromcode\fR
-to the \fItocode\fR encoding.
-.SH OPTIONS
-.TP
+.SH "SYNOPSIS"
+.HP \w'\fBuniconv\fR\fB\fR\ 'u
+\fBuniconv\fR\fB\fR [\-ndv] \-c\ \fIcnidbackend\fR \-f\ \fIfromcode\fR \-t\ \fItocode\fR [\-m\ \fImaccode\fR] \fIvolumepath\fR
+.SH "DESCRIPTION"
+.PP
+\fBuniconv\fR
+converts the volume encoding of
+\fIvolumepath\fR
+from the
+\fIfromcode\fR
+to the
+\fItocode\fR
+encoding\&.
+.SH "OPTIONS"
+.PP
\-c
-CNID backend used on this volume, usually cdb or dbd. Should
-match the backend selected with afpd for this volume. If not
-specified, the default CNID backend `:DEFAULT_CNID_SCHEME:' is
-used
-.TP
+.RS 4
+CNID backend used on this volume, usually cdb or dbd\&. Should match the backend selected with afpd for this volume\&. If not specified, the default CNID backend `:DEFAULT_CNID_SCHEME:\' is used
+.RE
+.PP
\-d
-don't CAP encode leading dots (:2e), equivalent to
-\fBusedots\fR in \fBAppleVolumes.default\fR(5)
-.TP
+.RS 4
+don\'t CAP encode leading dots (:2e), equivalent to
+\fBusedots\fR
+in
+\fBAppleVolumes.default\fR(5)
+.RE
+.PP
\-f
+.RS 4
encoding to convert from, use ASCII for CAP encoded volumes
-.TP
+.RE
+.PP
\-h
+.RS 4
display help
-.TP
+.RE
+.PP
\-m
-Macintosh client codepage, required for CAP encoded volumes.
-Defaults to `MAC_ROMAN'
-.TP
+.RS 4
+Macintosh client codepage, required for CAP encoded volumes\&. Defaults to `MAC_ROMAN\'
+.RE
+.PP
\-n
-`dry run', don't do any real changes
-.TP
+.RS 4
+`dry run\', don\'t do any real changes
+.RE
+.PP
\-t
-volume encoding to convert to, e.g. UTF8
-.TP
+.RS 4
+volume encoding to convert to, e\&.g\&. UTF8
+.RE
+.PP
\-v
-verbose output, use twice for maximum logging.
-.TP
+.RS 4
+verbose output, use twice for maximum logging\&.
+.RE
+.PP
\-V
+.RS 4
print version and exit
+.RE
.PP
-.SH WARNING
-Setting the wrong options might render your data unusable!!! Make
-sure you know what you are doing. Always backup your data first.
+.SH "WARNING"
.PP
-It is \fB*strongly*\fR recommended to do
-a `dry run' first and to check the output for conversion errors.
+Setting the wrong options might render your data unusable!!! Make sure you know what you are doing\&. Always backup your data first\&.
+.PP
+It is
+\fB*strongly*\fR
+recommended to do a `dry run\' first and to check the output for conversion errors\&.
.PP
\fBafpd\fR(8)
-should \fInot\fR be running while you change the volume
-encoding. Remember to change \fBvolcodepage\fR in
+should
+\fInot\fR
+be running while you change the volume encoding\&. Remember to change
+\fBvolcodepage\fR
+in
\fBAppleVolumes.default\fR(5)
-to the new codepage, before restarting afpd.
+to the new codepage, before restarting afpd\&.
+.PP
+In case of
+\fBMacChineseTraditional\fR,
+\fBMacJapanese\fR
+or
+\fBMacKorean\fR, uniconv cannot be used\&.
.PP
\fBUSE AT YOUR OWN RISK!!!\fR
.SH "SELECTABLE CHARSETS"
-Netatalk provides internal support for UTF\-8 (pre\- and decomposed)
-and CAP. If you want to use other charsets, they must be provided by
+.PP
+Netatalk provides internal support for UTF\-8 (pre\- and decomposed) and CAP\&. If you want to use other charsets, they must be provided by
\fBiconv\fR(1)
.PP
-uniconv also knows iso\-8859.adapted, an old style
-1.x NLS widely used. This is only intended for upgrading old volumes,
+\fBuniconv\fR
+also knows iso\-8859\&.adapted, an old style 1\&.x NLS widely used\&. This is only intended for upgrading old volumes,
\fBafpd\fR(8)
-cannot handle iso\-8859.adapted anymore.
+cannot handle iso\-8859\&.adapted anymore\&.
.SH "CNID BACKGROUND"
-The CNID backends maintains name to ID mappings. If you change a
-filename outside afpd(8) (shell, samba), the CNID db, i.e. the DIDNAME
-index, gets inconsistent. Netatalk tries to recover from such
-inconsistencies as gracefully as possible. The mechanisms to resolve such
-inconsistencies may fail sometimes, though, as this is not an easy task to
-accomplish. I.e. if several names in the path to the file or directory
-have changed, things may go wrong.
-.PP
-If you change a lot of filenames at once, chances are higher that
-the afpds fallback mechanisms fail, i.e. files will be assigned new IDs,
-even though the file hasn't changed. uniconv
-therefore updates the CNID entry for each file/directory directly after it
-changes the name to avoid inconsistencies. The two supported backends for
-volumes, dbd and cdb, use the same CNID db format. Therefore, you
-\fIcould\fR use uniconv with cdb and
-afpd with dbd later.
-.PP
-\fBWarning\fR: There must not be two
-processes opening the CNID database using different backends at once! If a
-volume is still opened with dbd (cnid_metad/cnid_dbd) and you start
-uniconv with cdb, the result will be a corrupted CNID
-database, as the two backends use different locking schemes. You might run
-into additional problems, e.g. if dbd is compiled with transactions, cdb
-will not update the transaction logs.
+.PP
+The CNID backends maintains name to ID mappings\&. If you change a filename outside afpd(8) (shell, samba), the CNID db, i\&.e\&. the DIDNAME index, gets inconsistent\&. Netatalk tries to recover from such inconsistencies as gracefully as possible\&. The mechanisms to resolve such inconsistencies may fail sometimes, though, as this is not an easy task to accomplish\&. I\&.e\&. if several names in the path to the file or directory have changed, things may go wrong\&.
+.PP
+If you change a lot of filenames at once, chances are higher that the afpds fallback mechanisms fail, i\&.e\&. files will be assigned new IDs, even though the file hasn\'t changed\&.
+\fBuniconv\fR
+therefore updates the CNID entry for each file/directory directly after it changes the name to avoid inconsistencies\&. The two supported backends for volumes, dbd and cdb, use the same CNID db format\&. Therefore, you
+\fIcould\fR
+use
+\fBuniconv\fR
+with cdb and
+\fBafpd\fR
+with dbd later\&.
+.PP
+\fBWarning\fR: There must not be two processes opening the CNID database using different backends at once! If a volume is still opened with dbd (cnid_metad/cnid_dbd) and you start
+\fBuniconv\fR
+with cdb, the result will be a corrupted CNID database, as the two backends use different locking schemes\&. You might run into additional problems, e\&.g\&. if dbd is compiled with transactions, cdb will not update the transaction logs\&.
.PP
In general, it is recommended to use the same backend for
-uniconv you are using with
-\fBafpd\fR(8).
-.SH EXAMPLES
-convert 1.x CAP encoded volume to UTF\-8, clients used MacRoman
-codepage, cnidscheme is dbd:
+\fBuniconv\fR
+you are using with
+\fBafpd\fR(8)\&.
+.SH "EXAMPLES"
.PP
+convert 1\&.x CAP encoded volume to UTF\-8, clients used MacRoman codepage, cnidscheme is dbd:
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
example%\fB uniconv \-c dbd \-f ASCII \-t UTF8 \-m MAC_ROMAN /path/to/share\fR
.fi
+.if n \{\
+.RE
+.\}
.PP
convert iso8859\-1 volume to UTF\-8, cnidscheme is cdb:
-.PP
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
example%\fB uniconv \-c cdb \-f ISO\-8859\-1 \-t UTF8 \-m MAC_ROMAN /path/to/share\fR
.fi
+.if n \{\
+.RE
+.\}
.PP
-convert 1.x volume using iso8859\-1 adapted NLS to CAP encoding:
-.PP
+convert 1\&.x volume using iso8859\-1 adapted NLS to CAP encoding:
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
example%\fB uniconv \-f ISO\-8859\-ADAPTED \-t ASCII \-m MAC_ROMAN/path/to/share\fR
.fi
+.if n \{\
+.RE
+.\}
.PP
convert UTF\-8 volume to CAP, for MacCyrillic clients:
-.PP
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
example%\fB uniconv \-f UTF8 \-t ASCII \-m MAC_CYRILLIC /path/to/share\fR
.fi
+.if n \{\
+.RE
+.\}
.SH "SEE ALSO"
+.PP
\fBAppleVolumes.default\fR(5),\fBafpd\fR(8),\fBiconv\fR(1),\fBcnid_metad\fR(8),\fBcnid_dbd\fR(8)
-
-.TH atalk_aton 3 "12 Jan 1994" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: atalk_aton
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 12 Jan 1994
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "ATALK_ATON" "3" "12 Jan 1994" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
atalk_aton \- AppleTalk address parsing
-.SH SYNOPSIS
+.SH "SYNOPSIS"
+.sp
+.ft B
.nf
-#include <sys/types.h>
-#include <netatalk/at.h>
+#include <sys/types\&.h>
+#include <netatalk/at\&.h>
.fi
-.sp 1
+.ft
+.HP \w'atalk_aton('u
+.BI "atalk_aton(char\ *\ " "cp" ", struct\ at_addr\ *\ " "ata" ");"
+.SH "DESCRIPTION"
.PP
-\fIatalk_aton\fR(char * \fIcp\fR, struct at_addr * \fIata\fR);
-.SH DESCRIPTION
-The atalk_aton() routine converts an ASCII
-representation of an AppleTalk address to a format appropriate for system
-calls. Acceptable ASCII representations include both hex and base 10, in
-triples or doubles. For instance, the address `0x1f6b.77' has a
-network part of `8043' and a node part of `119'. This same address
-could be written `8043.119', `31.107.119', or `0x1f.6b.77'. If
-the address is in hex and the first digit is one of `A\-F', a leading
-`0x' is redundant.
+The
+\fBatalk_aton()\fR
+routine converts an ASCII representation of an AppleTalk address to a format appropriate for system calls\&. Acceptable ASCII representations include both hex and base 10, in triples or doubles\&. For instance, the address `0x1f6b\&.77\' has a network part of `8043\' and a node part of `119\'\&. This same address could be written `8043\&.119\', `31\&.107\&.119\', or `0x1f\&.6b\&.77\'\&. If the address is in hex and the first digit is one of `A\-F\', a leading `0x\' is redundant\&.
.SH "SEE ALSO"
-\fBatalk\fR(4).
-
+.PP
+\fBatalk\fR(4)\&.
-.TH nbp_name 3 "12 Jan 1994" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: nbp_name
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 12 Jan 1994
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "NBP_NAME" "3" "12 Jan 1994" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
nbp_name \- NBP name parsing
-.SH SYNOPSIS
-int \fInbp_name\fR(char *\fIname\fR, char **\fIobj\fR, char **\fItype\fR, char **\fIzone\fR);
-.SH DESCRIPTION
-nbp_name() parses user supplied names into
-their component object, type, and zone. \fIobj\fR,
-\fItype\fR, and zone
-should be passed by reference, and should point to the caller's
-default values. nbp_name() will change the pointers
-to the parsed\-out values. \fIname\fR is of the
-form \fIobject\fR\fI:\fR\fI\fR\fItype\fR\fI@\fR\fI\fRzone, where each of \fIobject\fR,
-\fI:\fR\fItype\fR\fI,\fR and \fI@\fRzone replace \fIobj\fR,
-\fItype\fR, and \fIzone,\fR
-respectively. \fItype\fR must be proceeded by `\fI:\fR', and zone
-must be preceded by `\fI@\fR'.
-.SH EXAMPLE
-The argument of \fBafpd\fR(8)'s
-\fB\-n\fR option is parsed with nbp_name().
-The default value of \fIobj\fR is the first
-component of the machine's hostname (as returned by
-\fBgethostbyname\fR(3)).
-The default value of \fItype\fR is
-``AFPServer'', and of zone is
-``*'', the default zone. To cause \fIafpd\fR
-to register itself in some zone other than the default, one would invoke
-it as
+.SH "SYNOPSIS"
+.HP \w'int\ nbp_name('u
+.BI "int nbp_name(char\ *" "name" ", char\ **" "obj" ", char\ **" "type" ", char\ **" "zone" ");"
+.SH "DESCRIPTION"
.PP
+\fBnbp_name()\fR
+parses user supplied names into their component object, type, and zone\&.
+\fBobj\fR,
+\fBtype\fR, and
+\fIzone\fR
+should be passed by reference, and should point to the caller\'s default values\&.
+\fBnbp_name()\fR
+will change the pointers to the parsed\-out values\&.
+\fBname\fR
+is of the form
+\fIobject\fR\fB:\fR\fItype\fR\fB@\fR\fIzone\fR, where each of
+\fIobject\fR,
+\fB:\fR\fItype\fR\fB,\fR
+and
+\fB@\fR\fIzone\fR
+replace
+\fBobj\fR,
+\fBtype\fR, and
+\fBzone,\fR
+respectively\&.
+\fItype\fR
+must be proceeded by `\fB:\fR\', and
+\fIzone\fR
+must be preceded by `\fB@\fR\'\&.
+.SH "EXAMPLE"
+.PP
+The argument of
+\fBafpd\fR(8)\'s
+\fB\-n\fR
+option is parsed with
+\fBnbp_name()\fR\&. The default value of
+\fBobj\fR
+is the first component of the machine\'s hostname (as returned by
+\fBgethostbyname\fR(3))\&. The default value of
+\fBtype\fR
+is ``AFPServer\'\', and of
+\fIzone\fR
+is ``*\'\', the default zone\&. To cause
+\fBafpd\fR
+to register itself in some zone other than the default, one would invoke it as
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
afpd \-n @some\-other\-zone
.fi
+.if n \{\
+.RE
+.\}
+.PP
+\fBobj\fR
+and
+\fBtype\fR
+would retain their default values\&.
+.SH "BUGS"
.PP
-\fIobj\fR and \fItype\fR
-would retain their default values.
-.SH BUGS
-\fIobj\fR, \fItype\fR,
-and zone return pointers into static
-area which may be over\-written on each call.
-
+\fBobj\fR,
+\fBtype\fR, and
+\fIzone\fR
+return pointers into static area which may be over\-written on each call\&.
-.TH atalk 4 "17 Dec 1991" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: atalk
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 17 Dec 1991
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "ATALK" "4" "17 Dec 1991" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
atalk \- AppleTalk protocol family
-.SH SYNOPSIS
+.SH "SYNOPSIS"
+.sp
+.ft B
.nf
-#include <sys/types.h>
-#include <netatalk/at.h>
+#include <sys/types\&.h>
+#include <netatalk/at\&.h>
.fi
-.sp 1
-.SH DESCRIPTION
-The AppleTalk protocol family is a collection of protocols layered
-above the Datagram Delivery Protocol (DDP), and using AppleTalk address
-format. The AppleTalk family may provide SOCK_STREAM (ADSP), SOCK_DGRAM
-(DDP), SOCK_RDM (ATP), and SOCK_SEQPACKET (ASP). Currently, only DDP is
-implemented in the kernel; ATP and ASP are implemented in user level
-libraries; and ADSP is planned.
-.SH ADDRESSING
-AppleTalk addresses are three byte quantities, stored in network
-byte order. The include file <\fInetatalk/at.h\fR>
-defines the AppleTalk address format.
+.ft
+.SH "DESCRIPTION"
.PP
-Sockets in the AppleTalk protocol family use the following address
-structure:
+The AppleTalk protocol family is a collection of protocols layered above the Datagram Delivery Protocol (DDP), and using AppleTalk address format\&. The AppleTalk family may provide SOCK_STREAM (ADSP), SOCK_DGRAM (DDP), SOCK_RDM (ATP), and SOCK_SEQPACKET (ASP)\&. Currently, only DDP is implemented in the kernel; ATP and ASP are implemented in user level libraries; and ADSP is planned\&.
+.SH "ADDRESSING"
.PP
+AppleTalk addresses are three byte quantities, stored in network byte order\&. The include file <\fBnetatalk/at\&.h\fR> defines the AppleTalk address format\&.
+.PP
+Sockets in the AppleTalk protocol family use the following address structure:
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
struct sockaddr_at {
short sat_family;
char sat_zero[ 8 ];
};
.fi
+.if n \{\
+.RE
+.\}
.PP
-The port of a socket may be set with \fBbind\fR(2).
-The node for \fIbind\fR must always be \fIATADDR_ANYNODE\fR: ``this node.'' The net may be
-\fIATADDR_ANYNET\fR or \fIATADDR_LATENET\fR.
-\fIATADDR_ANYNET\fR coresponds to the
-machine's ``primary'' address (the first configured).
-\fIATADDR_LATENET\fR causes the address in
-outgoing packets to be determined when a packet is sent, i.e. determined
-late. \fIATADDR_LATENET\fR is equivalent to
-opening one socket for each network interface. The port of a socket and
-either the primary address or \fIATADDR_LATENET\fR
-are returned with \fBgetsockname\fR(2).
+The port of a socket may be set with
+\fBbind\fR(2)\&. The node for
+\fBbind\fR
+must always be
+\fBATADDR_ANYNODE\fR: ``this node\&.\'\' The net may be
+\fBATADDR_ANYNET\fR
+or
+\fBATADDR_LATENET\fR\&.
+\fBATADDR_ANYNET\fR
+coresponds to the machine\'s ``primary\'\' address (the first configured)\&.
+\fBATADDR_LATENET\fR
+causes the address in outgoing packets to be determined when a packet is sent, i\&.e\&. determined late\&.
+\fBATADDR_LATENET\fR
+is equivalent to opening one socket for each network interface\&. The port of a socket and either the primary address or
+\fBATADDR_LATENET\fR
+are returned with
+\fBgetsockname\fR(2)\&.
.SH "SEE ALSO"
+.PP
\fBbind\fR(2),
\fBgetsockname\fR(2),
-\fBatalkd\fR(8).
-
+\fBatalkd\fR(8)\&.
.\" Title: AppleVolumes.default
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
-.\" Date: 02 Octobre 2009
-.\" Manual: Netatalk 2.1
-.\" Source: Netatalk 2.1
+.\" Date: 23 Dec 2009
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
.\" Language: English
.\"
-.TH "APPLEVOLUMES\&.DEFAU" "5" "02 Octobre 2009" "Netatalk 2.1" "Netatalk 2.1"
+.TH "APPLEVOLUMES\&.DEFAU" "5" "23 Dec 2009" "Netatalk 2.1beta" "Netatalk 2.1beta"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.sp .5v
.RE
.PP
+It is possible to specify default options for all volumes with a
+\fI:DEFAULT: \fRline preceeding these volume definitions:.PP \fBExample.\ \&:DEFAULT: configuration line\fR .PP :DEFAULT: options:upriv,usedots dbpath:/var/dbd/AppleDB/$v dperm:0775 fperm:0664
+.PP
The possible options and their meanings are:
.PP
adouble:\fI[v1|v2|osx]\fR
The deny option specifies users and groups who are not allowed access to the share\&. It follows the same format as the allow option\&.
.RE
.PP
-allowed_hosts:\fI[IPv4 host address/IPv4 netmask bits[, \&.\&.\&. ]]\fR
+allowed_hosts:\fI[IP host address/IP netmask bits[, \&.\&.\&. ]]\fR
.RS 4
-Only listed hosts and networks are allowed, all others are rejected\&. Example: allowed_hosts:10\&.1\&.0\&.0/16,10\&.2\&.1\&.100
+Only listed hosts and networks are allowed, all others are rejected\&. The network address may be specified either in dotted\-decimal format for IPv4 or in hexadecimal format for IPv6\&.
+.sp
+Example: allowed_hosts:10\&.1\&.0\&.0/16,10\&.2\&.1\&.100,2001:0db8:1234::/48
.RE
.PP
-denied_hosts:\fI[IPv4 host address/IPv4 netmask bits[, \&.\&.\&.]]\fR
+denied_hosts:\fI[IP host address/IP netmask bits[, \&.\&.\&.]]\fR
.RS 4
-Listed hosts and nets are rejected, all others are allowed\&. Example: denied_hosts: 192\&.168\&.100/24,10\&.1\&.1\&.1
+Listed hosts and nets are rejected, all others are allowed\&.
+.sp
+Example: denied_hosts: 192\&.168\&.100/24,10\&.1\&.1\&.1,2001:db8::1428:57ab
.RE
.PP
cnidscheme:\fI[backend]\fR
Sets the database information to be stored in path\&. You have to specifiy a writable location, even if the volume is read only\&.
.RE
.PP
-ea:\fI[sys|ad]\fR
+ea:\fI[none|auto|sys|ad]\fR
.RS 4
-Specify the format of the metadata files which are used for saving Extended Attributes\&.
+Specify how Extended Attributes
+are stored\&.
+\fBauto\fR
+is the default\&.
+.PP
+auto
+.RS 4
+Try
\fBsys\fR
-is the default and stores the EAs in native filesystem Extended Attributes\&.
-\fBad\fR
-uses ordinary files inside the \&.AppleDouble directories\&.
+(by setting an EA on the shared directory itself), fallback to
+\fBad\fR\&. Requires writeable volume for perfoming test\&.
+\fBoptions:ro\fR
+overwrites
+\fBauto\fR
+with
+\fBnone\fR\&. Use explicit
+\fBea:sys|ad\fR
+for read\-only volumes where appropiate\&.
+.RE
+.PP
+sys
+.RS 4
+Use filesystem Extended Attributes\&.
+.RE
+.PP
+ad
+.RS 4
+Use files in
+\fIAppleDouble\fR
+directories\&.
+.RE
+.PP
+none
+.RS 4
+No Extended Attributes support\&.
+.RE
.RE
.PP
maccharset:\fI[charset]\fR
.RS 4
Specifies the share as being read only for all users\&. The \&.AppleDB directory has to be writeable, you can use the
\fB\-dbpath\fR
-option to relocate it\&.
+option to relocate it\&. Overwrites
+\fBea:auto\fR
+with
+\fBea:none\fR
.RE
.PP
root_preexec_close
.RS 4
This allows multiple options to be specified in a comma delimited format\&. The available options are:
.PP
-nocnidcache
+caseinsensitive
.RS 4
-If set
-\fBafpd\fR
-doesn\'t store the ID information in AppleDouble V2 header files\&. As these IDs are used for caching and as a database backup, this option normally shouldn\'t be set\&.
+The underlying filesystem is case insensitive (only tested with JFS in OS2 mode)\&.
.RE
.PP
crlf
whenever possible\&.
.RE
.PP
+nocnidcache
+.RS 4
+If set
+\fBafpd\fR
+doesn\'t store the ID information in AppleDouble V2 header files\&. As these IDs are used for caching and as a database backup, this option normally shouldn\'t be set\&.
+.RE
+.PP
nodev
.RS 4
always use 0 for device number, helps when the device number is not constant across a reboot, cluster, \&.\&.\&.
.SH "SEE ALSO"
.PP
\fBafpd.conf\fR(5),
-\fBafpd\fR(8)
+\fBafpd\fR(8),
+\fBafp_ldap.conf\fR(5),
+\fBafp_acls\fR(8)
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
.\" Date: 28 November 2009
-.\" Manual: Netatalk 2.1
-.\" Source: Netatalk 2.1
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
.\" Language: English
.\"
-.TH "AFP_LDAP\&.CONF" "5" "28 November 2009" "Netatalk 2.1" "Netatalk 2.1"
+.TH "AFP_LDAP\&.CONF" "5" "28 November 2009" "Netatalk 2.1beta" "Netatalk 2.1beta"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
-.TH afpd.conf 5 "24 September 2004" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: afpd.conf
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 23 December 2009
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "AFPD\&.CONF" "5" "23 December 2009" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
afpd.conf \- Configuration file used by afpd(8) to determine the setup of its file sharing services
-.SH DESCRIPTION
-\fB:ETCDIR:/afpd.conf\fR is the configuration file
-used by afpd to determine the behavior and
-configuration of the different virtual file servers that it
-provides.
-.PP
-Any line not prefixed with # is interpreted. The configuration lines
-are composed like: server name [ options ] If a \fB\-\fR is used
-instead of a server name, the default server is specified. Server names
-must be quoted if they contain spaces. They must not contain ":" or "@".
-The path name must be a fully qualified path name, or a path name using
-either the ~ shell shorthand or any of the substitution variables, which
-are listed below.
-.PP
-.RS
+.SH "DESCRIPTION"
+.PP
+:ETCDIR:/afpd\&.conf
+is the configuration file used by
+\fBafpd\fR
+to determine the behavior and configuration of the different virtual file servers that it provides\&.
+.PP
+Any line not prefixed with # is interpreted\&. The configuration lines are composed like: server name [ options ] If a
+\fB\-\fR
+is used instead of a server name, the default server is specified\&. Server names must be quoted if they contain spaces\&. They must not contain ":" or "@"\&. The path name must be a fully qualified path name, or a path name using either the ~ shell shorthand or any of the substitution variables, which are listed below\&.
+.PP
+.if n \{\
+.sp
+.\}
+.RS 4
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
\fBNote\fR
+.ps -1
+.br
.PP
-Each server has to be configured on a \fBsingle\fR line.
+Each server has to be configured on a
+\fBsingle\fR
+line\&. Though newline escaping is supported\&.
+.sp .5v
.RE
-
The possible options and their meanings are:
.SH "APPLEVOLUMES FILES"
-.TP
+.PP
\-defaultvol \fI[path]\fR
-Specifies path to AppleVolumes.default file (default is
-\fB:ETCDIR:/AppleVolumes.default\fR).
-.TP
+.RS 4
+Specifies path to AppleVolumes\&.default file (default is
+:ETCDIR:/AppleVolumes\&.default)\&.
+.RE
+.PP
\-systemvol \fI[path]\fR
-Specifies path to AppleVolumes.system file (default is
-\fB:ETCDIR:/AppleVolumes.system\fR).
-.TP
+.RS 4
+Specifies path to AppleVolumes\&.system file (default is
+:ETCDIR:/AppleVolumes\&.system)\&.
+.RE
+.PP
\-[no]uservol
-Enables or disables reading of the users' individual volumes
-file entirely.
-.TP
+.RS 4
+Enables or disables reading of the users\' individual volumes file entirely\&.
+.RE
+.PP
\-[no]uservolfirst
-Enables or disables reading of the users' individual volumes
-file before processing the global
-\fBAppleVolumes.default\fR file.
+.RS 4
+Enables or disables reading of the users\' individual volumes file before processing the global
+AppleVolumes\&.default
+file\&.
+.RE
.SH "AUTHENTICATION METHODS"
-.TP
+.PP
\-uamlist \fI[uams list]\fR
-Comma separated list of UAMs. (The default is
-uams_guest.so,uams_clrtxt.so,uams_dhx.so).
-
+.RS 4
+Comma separated list of UAMs\&. (The default is uams_dhx\&.so,uams_dhx2\&.so)\&.
+.sp
The most commonly used UAMs are:
-.RS
-.TP
-uams_guest.so
+.PP
+uams_guest\&.so
+.RS 4
allows guest logins
-.TP
-uams_clrtxt.so
-(uams_pam.so or uams_passwd.so) Allow logins with
-passwords transmitted in the clear.
-.TP
-uams_randum.so
-allows Random Number and Two\-Way Random Number Exchange
-for authentication (requires a separate file containing the
-passwords, either :ETCDIR:/afppasswd file or the one specified
-via \fB\-passwdfile\fR. See \fBafppasswd\fR(1) for details
-.TP
-uams_dhx.so
-(uams_dhx_pam.so or uams_dhx_passwd.so) Allow
-Diffie\-Hellman eXchange (DHX) for authentication.
-.TP
-uam_gss.so
+.RE
+.PP
+uams_clrtxt\&.so
+.RS 4
+(uams_pam\&.so or uams_passwd\&.so) Allow logins with passwords transmitted in the clear\&.
+.RE
+.PP
+uams_randum\&.so
+.RS 4
+allows Random Number and Two\-Way Random Number Exchange for authentication (requires a separate file containing the passwords, either :ETCDIR:/afppasswd file or the one specified via
+\fB\-passwdfile\fR\&. See
+\fBafppasswd\fR(1)
+for details
+.RE
+.PP
+uams_dhx\&.so
+.RS 4
+(uams_dhx_pam\&.so or uams_dhx_passwd\&.so) Allow Diffie\-Hellman eXchange (DHX) for authentication\&.
+.RE
+.PP
+uams_dhx2\&.so
+.RS 4
+(uams_dhx2_pam\&.so or uams_dhx2_passwd\&.so) Allow Diffie\-Hellman eXchange 2 (DHX2) for authentication\&.
+.RE
+.PP
+uam_gss\&.so
+.RS 4
Allow Kerberos V for authentication (optional)
.RE
-.TP
+.RE
+.PP
\-uampath \fI[path]\fR
-Sets the default path for UAMs for this server (default is
-:ETCDIR:/uams).
-.TP
+.RS 4
+Sets the default path for UAMs for this server (default is :ETCDIR:/uams)\&.
+.RE
+.PP
\-k5keytab \fI[path]\fR, \-k5service \fI[service]\fR, \-k5realm \fI[realm]\fR
-These are required if the server supports the Kerberos 5
-authentication UAM.
+.RS 4
+These are required if the server supports the Kerberos 5 authentication UAM\&.
+.RE
+.PP
+\-ntdomain, \-ntseparator
+.RS 4
+Use for eg\&. winbind authentication, prepends both strings before the username from login and then tries to authenticate with the result through the availabel and active UAM authentication modules\&.
+.RE
.SH "CODEPAGE OPTIONS"
-With OS X Apple introduced the AFP3 protocol. One of the big changes
-was, that AFP3 uses Unicode names encoded as UTF\-8 decomposed. Previous
-AFP/OS versions used codepages like MacRoman, MacCentralEurope,
-etc.
+.PP
+With OS X Apple introduced the AFP3 protocol\&. One of the big changes was, that AFP3 uses Unicode names encoded as UTF\-8 decomposed\&. Previous AFP/OS versions used codepages like MacRoman, MacCentralEurope, etc\&.
.PP
To be able to serve AFP3 and older clients at the same time,
-afpd needs to be able to convert between UTF\-8 and Mac
-codepages. Even OS X clients partly still rely on codepages. As there's no
-way, afpd can detect the codepage a pre AFP3 client
-uses, you have to specify it using the \fB\-maccodepage\fR
-option. The default is MacRoman, which should be fine for most western
-users.
-.PP
-As afpd needs to interact with unix operating
-system as well, it need's to be able to convert from UTF\-8/MacCodepage to
-the unix codepage. By default afpd uses the systems
-LOCALE, or ASCII if your system doesn't support locales. You can set the
-unix codepage using the \fB\-unixcodepage\fR option. If you're
-using extended characters in the configuration files for
-afpd, make sure your terminal matches the
-\fB\-unixcodepage\fR.
-.TP
-\-unixcodepage [CODEPAGE]
-Specifies the servers unix codepage, e.g. "ISO\-8859\-15" or
-"UTF8". This is used to convert strings to/from the systems locale,
-e.g. for authenthication, server messages and volume names. Defaults
-to LOCALE if your system supports it, otherwise ASCII will be
-used.
-.TP
-\-maccodepage [CODEPAGE]
-Specifies the mac clients codepage, e.g. "MAC_ROMAN". This is
-used to convert strings and filenames to the clients codepage for
-OS9 and Classic, i.e. for authentication and AFP messages (SIGUSR2
-messaging). This will also be the default for the volumes
-maccharset. Defaults to MAC_ROMAN.
+\fBafpd\fR
+needs to be able to convert between UTF\-8 and Mac codepages\&. Even OS X clients partly still rely on codepages\&. As there\'s no way,
+\fBafpd\fR
+can detect the codepage a pre AFP3 client uses, you have to specify it using the
+\fB\-maccodepage\fR
+option\&. The default is MacRoman, which should be fine for most western users\&.
+.PP
+As
+\fBafpd\fR
+needs to interact with unix operating system as well, it need\'s to be able to convert from UTF\-8/MacCodepage to the unix codepage\&. By default
+\fBafpd\fR
+uses the systems LOCALE, or ASCII if your system doesn\'t support locales\&. You can set the unix codepage using the
+\fB\-unixcodepage\fR
+option\&. If you\'re using extended characters in the configuration files for
+\fBafpd\fR, make sure your terminal matches the
+\fB\-unixcodepage\fR\&.
+.PP
+\-unixcodepage [\fICODEPAGE\fR]
+.RS 4
+Specifies the servers unix codepage, e\&.g\&. "ISO\-8859\-15" or "UTF8"\&. This is used to convert strings to/from the systems locale, e\&.g\&. for authenthication, server messages and volume names\&. Defaults to LOCALE if your system supports it, otherwise ASCII will be used\&.
+.RE
+.PP
+\-maccodepage [\fICODEPAGE\fR]
+.RS 4
+Specifies the mac clients codepage, e\&.g\&. "MAC_ROMAN"\&. This is used to convert strings and filenames to the clients codepage for OS9 and Classic, i\&.e\&. for authentication and AFP messages (SIGUSR2 messaging)\&. This will also be the default for the volumes maccharset\&. Defaults to MAC_ROMAN\&.
+.RE
.SH "PASSWORD OPTIONS"
-.TP
-\-loginmaxfail [number]
-Sets the maximum number of failed logins, if supported by the
-UAM (currently none)
-.TP
-\-passwdfile [path]
-Sets the path to the Randnum UAM passwd file for this server
-(default is :ETCDIR:/afppasswd).
-.TP
-\-passwdminlen [number]
-Sets the minimum password length, if supported by the
-UAM
-.TP
+.PP
+\-loginmaxfail [\fInumber\fR]
+.RS 4
+Sets the maximum number of failed logins, if supported by the UAM (currently none)
+.RE
+.PP
+\-passwdfile [\fIpath\fR]
+.RS 4
+Sets the path to the Randnum UAM passwd file for this server (default is :ETCDIR:/afppasswd)\&.
+.RE
+.PP
+\-passwdminlen [\fInumber\fR]
+.RS 4
+Sets the minimum password length, if supported by the UAM
+.RE
+.PP
\-[no]savepassword
-Enables or disables the ability of clients to save passwords
-locally
-.TP
+.RS 4
+Enables or disables the ability of clients to save passwords locally
+.RE
+.PP
\-[no]setpassword
-Enables or disables the ability of clients to change their
-passwords via chooser or the "connect to server" dialog
+.RS 4
+Enables or disables the ability of clients to change their passwords via chooser or the "connect to server" dialog
+.RE
.SH "TRANSPORT PROTOCOLS"
-.TP
+.PP
\-[no]ddp
-Enables or disables AFP\-over\-Appletalk. If
-\fB\-proxy\fR is specified, you must instead use
-\fB\-uamlist ""\fR to prevent DDP connections from
-working.
-.TP
+.RS 4
+Enables or disables AFP\-over\-Appletalk\&. If
+\fB\-proxy\fR
+is specified, you must instead use
+\fB\-uamlist ""\fR
+to prevent DDP connections from working\&.
+.RE
+.PP
\-[no]tcp
+.RS 4
Enables or disables AFP\-over\-TCP
-.TP
+.RE
+.PP
\-transall
+.RS 4
Make both available (default)
+.RE
.SH "TRANSPORT OPTIONS"
-.TP
+.PP
\-advertise_ssh
-Allows Mac OS X clients (10.3.3 or above) to automagically
-establish a tunneled AFP connection through SSH. If this option is
-set, the server's answers to client's FPGetSrvrInfo requests contain
-an additional entry. It depends on both client's settings and a
-correctly configured and running \fBsshd\fR(8) on the server to let things work.
-.RS
+.RS 4
+Allows Mac OS X clients (10\&.3\&.3 or above) to automagically establish a tunneled AFP connection through SSH\&. If this option is set, the server\'s answers to client\'s FPGetSrvrInfo requests contain an additional entry\&. It depends on both client\'s settings and a correctly configured and running
+\fBsshd\fR(8)
+on the server to let things work\&.
+.if n \{\
+.sp
+.\}
+.RS 4
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
\fBNote\fR
-
-Setting this option is not recommended since globally
-encrypting AFP connections via SSH will increase the server's load
-significantly. On the other hand, Apple's client side
-implementation of this feature in MacOS X versions prior to 10.3.4
-contained a security flaw.
+.ps -1
+.br
+Setting this option is not recommended since globally encrypting AFP connections via SSH will increase the server\'s load significantly\&. On the other hand, Apple\'s client side implementation of this feature in MacOS X versions prior to 10\&.3\&.4 contained a security flaw\&.
+.sp .5v
.RE
-.TP
+.RE
+.PP
\-ddpaddr \fI[ddp address]\fR
-Specifies the DDP address of the server. The default is to
-auto\-assign an address (0.0). This is only useful if you are running
-AppleTalk on more than one interface.
-.TP
+.RS 4
+Specifies the DDP address of the server\&. The default is to auto\-assign an address (0\&.0)\&. This is only useful if you are running AppleTalk on more than one interface\&.
+.RE
+.PP
\-fqdn \fI[name:port]\fR
-Specifies a fully\-qualified domain name, with an optional
-port. This is discarded if the server cannot resolve it. This option
-is not honored by AppleShare clients <= 3.8.3. This option is
-disabled by default. Use with caution as this will involve a second
-name resolution step on the client side. Also note that afpd will
-advertise this name:port combination but not automatically listen to
-it.
-.TP
+.RS 4
+Specifies a fully\-qualified domain name, with an optional port\&. This is discarded if the server cannot resolve it\&. This option is not honored by AppleShare clients <= 3\&.8\&.3\&. This option is disabled by default\&. Use with caution as this will involve a second name resolution step on the client side\&. Also note that afpd will advertise this name:port combination but not automatically listen to it\&.
+.RE
+.PP
+\-hostname\fI [name]\fR
+.RS 4
+Use this instead of the result from calling hostname for dertermening which IP address to advertise, therfore the hostname is resolved to an IP which is the advertised\&. This is NOT used for listening and it is also overwritten by
+\fB\-ipaddr\fR\&.
+.RE
+.PP
\-ipaddr \fI[ip address]\fR
+.RS 4
Specifies the IP address that the server should advertise
-\fBand\fR listens to (the default is the
-first IP address of the system). This option also allows to use one
-machine to advertise the AFP\-over\-TCP/IP settings of another machine
-via NBP when used together with the \fB\-proxy\fR
-option.
-.TP
+\fBand\fR
+listens to\&. The default is advertise the first IP address of the system, but to listen for any incoming request\&. The network address may be specified either in dotted\-decimal format for IPv4 or in hexadecimal format for IPv6\&. This option also allows to use one machine to advertise the AFP\-over\-TCP/IP settings of another machine via NBP
+when used together with the
+\fB\-proxy\fR
+option\&.
+.sp
+\fIExample IP/hostname configuration:\fR
+.sp
+fluxxus
+\fB\-hostname\fR
+afp\&.apple\&.com
+\fB\-ipaddr\fR
+127\&.0\&.0\&.1
+\fB\-fqdn\fR
+www\&.microsoft\&.com
+.sp
+Result:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(UTF8) Server name: "fluxxus"
+Listening and advertised network address: "127\&.0\&.0\&.1"
+Advertised network address: "www\&.microsoft\&.com"
+.fi
+.if n \{\
+.RE
+.\}
+.RE
+.PP
\-port \fI[port number]\fR
-Allows a different TCP port to be used for AFP\-over\-TCP. The
-default is 548.
-.TP
+.RS 4
+Allows a different TCP port to be used for AFP\-over\-TCP\&. The default is 548\&.
+.RE
+.PP
\-proxy
-Runs an AppleTalk proxy server for the specified AFP\-over\-TCP
-server. If the address and port aren't given, then the first IP
-address of the system and port 548 will be used. If you don't want
-the proxy server to act as a DDP server as well, set \fB\-uamlist
-""\fR.
-.TP
+.RS 4
+Runs an AppleTalk proxy server for the specified AFP\-over\-TCP server\&. If the address and port aren\'t given, then the first IP address of the system and port 548 will be used\&. If you don\'t want the proxy server to act as a DDP
+server as well, set
+\fB\-uamlist ""\fR\&.
+.RE
+.PP
\-server_quantum \fI[number]\fR
-This specifoes the DSI server quantum. The minimum value is
-303840 (0x4A2E0). The maximum value is 0xFFFFFFFFF. If you specify a
-value that is out of range, the default value will be set (which is
-the minimum). Do not change this value unless you're absolutely
-sure, what you're doing
-.TP
-\-noslp
-Do not register this server using the Service Location
-Protocol (if SLP support was compiled in). This is useful if you are
-running multiple servers and want one to be hidden, perhaps because
-it is advertised elsewhere, ie. by a SLP Directory Agent.
+.RS 4
+This specifies the DSI server quantum\&. The default value is 303840\&. The maximum value is 0xFFFFFFFFF, the minimum is 32000\&. If you specify a value that is out of range, the default value will be set\&. Do not change this value unless you\'re absolutely sure, what you\'re doing
+.RE
+.PP
+\-slp
+.RS 4
+Register this server using the Service Location Protocol (if SLP
+support was compiled in)\&.
+.RE
.SH "MISCELLANEOUS OPTIONS"
-.TP
+.PP
\-admingroup \fI[group]\fR
-Allows users of a certain group to be seen as the superuser
-when they log in. This option is disabled by default.
-.TP
+.RS 4
+Allows users of a certain group to be seen as the superuser when they log in\&. This option is disabled by default\&.
+.RE
+.PP
\-authprintdir \fI[path]\fR
-Specifies the path to be used (per server) to store the files
-required to do CAP\-style print authentication which papd will
-examine to determine if a print job should be allowed. These files
-are created at login and if they are to be properly removed, this
-directory probably needs to be umode 1777.
-.RS
+.RS 4
+Specifies the path to be used (per server) to store the files required to do CAP\-style print authentication which papd will examine to determine if a print job should be allowed\&. These files are created at login and if they are to be properly removed, this directory probably needs to be umode 1777\&.
+.if n \{\
+.sp
+.\}
+.RS 4
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
\fBNote\fR
-
-\fB\-authprintdir\fR will only work for clients
-connecting via DDP. Almost all modern Clients will use TCP.
+.ps -1
+.br
+\fB\-authprintdir\fR
+will only work for clients connecting via DDP\&. Almost all modern Clients will use TCP\&.
+.sp .5v
+.RE
.RE
-.TP
+.PP
\-client_polling
-With this switch enabled, afpd won't advertise that it is
-capable of server notifications, so that connected clients poll the
-server every 10 seconds to detect changes in opened server windows.
-\fINote\fR: Depending on the number of simultaneously
-connected clients and the network's speed, this can lead to a
-significant higher load on your network!
-.RS
+.RS 4
+With this switch enabled, afpd won\'t advertise that it is capable of server notifications, so that connected clients poll the server every 10 seconds to detect changes in opened server windows\&.
+\fINote\fR: Depending on the number of simultaneously connected clients and the network\'s speed, this can lead to a significant higher load on your network!
+.if n \{\
+.sp
+.\}
+.RS 4
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
\fBNote\fR
-
-Do not use this option any longer as Netatalk 2.0 correctly
-supports server notifications, allowing connected clients to
-update folder listings in case another client changed the
-contents.
+.ps -1
+.br
+Do not use this option any longer as Netatalk 2\&.0 correctly supports server notifications, allowing connected clients to update folder listings in case another client changed the contents\&.
+.sp .5v
+.RE
.RE
-.TP
+.PP
+\-closevol
+.RS 4
+Immediately unmount volumes removed from AppleVolumes files on SIGHUP sent to the afp master process\&.
+.RE
+.PP
\-cnidserver \fI[ipaddress:port]\fR
-Specifies the IP address and port of a cnid_metad server,
-required for CNID dbd backend. Defaults to localhost:4700.
-.TP
+.RS 4
+Specifies the IP address and port of a cnid_metad server, required for CNID dbd backend\&. Defaults to localhost:4700\&. The network address may be specified either in dotted\-decimal format for IPv4 or in hexadecimal format for IPv6\&.
+.RE
+.PP
\-guestname \fI[name]\fR
-Specifies the user that guests should use (default is
-"nobody"). The name should be quoted.
-.TP
-\-icon
-Use the platform\-specific icon
-.TP
+.RS 4
+Specifies the user that guests should use (default is "nobody")\&. The name should be quoted\&.
+.RE
+.PP
+\-[no]icon
+.RS 4
+[Dont\'t] Use the platform\-specific icon
+.RE
+.PP
\-loginmesg \fI[message]\fR
-Sets a message to be displayed when clients logon to the
-server. The message should be in \fBunixcodepage\fR and
-should be quoted. Extended characters are allowed.
-.TP
+.RS 4
+Sets a message to be displayed when clients logon to the server\&. The message should be in
+\fBunixcodepage\fR
+and should be quoted\&. Extended characters are allowed\&.
+.RE
+.PP
\-nodebug
-Disables debugging.
-.TP
+.RS 4
+Disables debugging\&.
+.RE
+.PP
\-sleep \fI[number]\fR
-AFP 3.x waits number hours before
-disconnecting clients in sleep mode. Default is 10 hours.
-.TP
+.RS 4
+AFP 3\&.x waits
+\fInumber\fR
+hours before disconnecting clients in sleep mode\&. Default is 10 hours\&.
+.RE
+.PP
\-signature { user:<text> | host }
-Specify a server signature. This option is useful while
-running multiple independent instances of afpd on one machine (eg.
-in clustered environments, to provide fault isolation etc.). "host"
-signature type allows afpd generating signature automatically (based
-on machine primary IP address). "user" signature type allows
-administrator to set up a signature string manually. The maximum
-length is 16 characters
-
-\fBThree server definitions using 2 different server
-signatures\fR
-
+.RS 4
+Specify a server signature\&. This option is useful while running multiple independent instances of afpd on one machine (eg\&. in clustered environments, to provide fault isolation etc\&.)\&. "host" signature type allows afpd generating signature automatically (based on machine primary IP address)\&. "user" signature type allows administrator to set up a signature string manually\&. The maximum length is 16 characters
+.PP
+\fBExample.\ \&Three server definitions using 2 different server signatures\fR
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
first \-signature user:USERS
second \-signature user:USERS
third \-signature user:ADMINS
.fi
+.if n \{\
+.RE
+.\}
+
-First two servers will appear as one logical AFP service to
-the clients \- if user logs in to first one and then connects to
-second one, session will be automatically redirected to the first
-one. But if client connects to first and then to third, will be
-asked for password twice and will see resources of both servers.
-Traditional method of signature generation causes two independent
-afpd instances to have the same signature and thus cause clients to
-be redirected automatically to server (s)he logged in first.
+First two servers will appear as one logical AFP service to the clients \- if user logs in to first one and then connects to second one, session will be automatically redirected to the first one\&. But if client connects to first and then to third, will be asked for password twice and will see resources of both servers\&. Traditional method of signature generation causes two independent afpd instances to have the same signature and thus cause clients to be redirected automatically to server (s)he logged in first\&.
+.RE
+.PP
+\-volnamelen \fI[number] \fR
+.RS 4
+Max length of UTF8\-MAC volume name for Mac OS X\&. Note that Hangul is especially sensitive to this\&.
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+73: limit of Mac OS X 10\&.1
+80: limit for Mac OS X 10\&.4/10\&.5 (default)
+123: limit for Mac OS X 10\&.6
+255: limit of spec
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Mac OS 9 and earlier are not influenced by this, because Maccharset volume name is always limitted to 27 bytes\&.
+.RE
.SH "LOGGING OPTIONS"
-.RS
+.PP
+\-setuplog "\fI<logtype> <loglevel> [<filename>]\fR"
+.RS 4
+Specify that any message of a loglevel up to the given
+\fBloglevel\fR
+should be logged to the given file\&. If the filename is ommited the loglevel applies to messages passed to syslog\&.
+.sp
+By default (no explicit
+\fB\-setuplog\fR
+and no buildtime configure flag
+\fB\-\-with\-logfile\fR) afpd logs to syslog with a default logging setup equivalent to
+\fB"\-setuplog default log_note\fR"\&.
+.sp
+If build with
+\fB\-\-with\-logfile\fR
+(default logfile
+\fI/var/log/netatalk\&.log\fR) or
+\fB\-\-with\-logfile=somefile\fR
+afpd defaults to a setup that is equivalent to "\fB\-setuplog default log_note [\fR\fB\fInetatalk\&.log|somefile]\fR\fR"\&.
+.sp
+logtypes: Default, AFPDaemon, Logger, UAMSDaemon
+.sp
+loglevels: LOG_SEVERE, LOG_ERROR, LOG_WARN, LOG_NOTE, LOG_INFO, LOG_DEBUG, LOG_DEBUG6, LOG_DEBUG7, LOG_DEBUG8, LOG_DEBUG9, LOG_MAXDEBUG
+.if n \{\
+.sp
+.\}
+.RS 4
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
\fBNote\fR
+.ps -1
+.br
+The config is case\-ignoring
+.sp .5v
+.RE
.PP
-Extended logging capabilities are only available if Netatalk was
-built using \-\-with\-logfile. As of Netatalk 2.0, the
-default is \-\-without\-logfile since the logger code is
-partially broken and needs a complete rewrite (the
-\fB\-setuplog\fR option might not work as expected). If
-Netatalk was built without logger support then the daemons log to
-syslog.
-.RE
-.TP
-\-[un]setuplog "<logtype> <loglevel> [<filename>]"
-Specify that the given loglevel should be applied to log
-messages of the given logtype and that these messages should be
-logged to the given file. If the filename is ommited the loglevel
-applies to messages passed to syslog. Each logtype may have a
-loglevel applied to syslog and a loglevel applied to a single file.
-Latter \fB\-setuplog\fR settings will override earlier
-ones of the same logtype (file or syslog).
-
-logtypes: Default, Core, Logger, CNID, AFP
-
-Daemon loglevels: LOG_SEVERE, LOG_ERROR, LOG_WARN, LOG_NOTE,
-LOG_INFO, LOG_DEBUG, LOG_DEBUG6, LOG_DEBUG7, LOG_DEBUG8, LOG_DEBUG9,
-LOG_MAXDEBUG
-
-\fBSome ways to change afpd's logging behaviour via
-\-[un]setuplog\fR
-
-Example:
-
+\fBExample.\ \&Useful default config\fR
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+\-setuplog "default log_info /var/log/afpd\&.log"
+.fi
+.if n \{\
+.RE
+.\}
+.PP
+\fBExample.\ \&Debugging config\fR
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+\-setuplog "default log_maxdebug /var/log/afpd\&.log"
+.fi
+.if n \{\
+.RE
+.\}
+.PP
+\fBExample.\ \&afpd logging to different files\fR
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+\-setuplog "default log_info /var/log/afpd\&.log"
+\-setuplog "UAMSDaemon log_maxdebug /var/log/uams\&.log"
+.fi
+.if n \{\
+.RE
+.\}
+.RE
+.PP
+\-unsetuplog "\fI<logtype> [<filename>]\fR"
+.RS 4
+Note that for
+\fBunsetuplog\fR
+specifying any string as filename is sufficient for the config parser to distinguish between requests to disable syslog logging or file\-logging\&.
+.PP
+\fBExample.\ \&Disable afpd logging set at build-time from configure\fR
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
-\-setuplog "logger log_maxdebug /var/log/netatalk\-logger.log"
-\-setuplog "afpdaemon log_maxdebug /var/log/netatalk\-afp.log"
-\-unsetuplog "default level file"
-\-setuplog "default log_maxdebug"
+\-unsetuplog "default \-"
.fi
+.if n \{\
+.RE
+.\}
+.RE
.SH "DEBUG OPTIONS"
-These options are useful for debugging only.
-.TP
+.PP
+These options are useful for debugging only\&.
+.PP
\-tickleval \fI[number]\fR
-Sets the tickle timeout interval (in seconds). Defaults to
-30.
-.TP
+.RS 4
+Sets the tickle timeout interval (in seconds)\&. Defaults to 30\&.
+.RE
+.PP
\-timeout \fI[number]\fR
-Specify the number of tickles to send before timing out a
-connection. The default is 4, therefore a connection will timeout
-after 2 minutes.
-.SH EXAMPLES
-\fBafpd.conf default configuration\fR
+.RS 4
+Specify the number of tickles to send before timing out a connection\&. The default is 4, therefore a connection will timeout after 2 minutes\&.
+.RE
+.SH "EXAMPLES"
.PP
+\fBExample.\ \&afpd.conf default configuration\fR
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
-\- \-transall \-uamlist uams_clrtxt.so,uams_dhx.so,uams_guest.so
+\- \-transall \-uamlist uams_dhx\&.so,uams_dhx2\&.so
.fi
+.if n \{\
+.RE
+.\}
.PP
-\fBafpd.conf MacCyrillic setup / UTF8 unix locale\fR
-.PP
+\fBExample.\ \&afpd.conf MacCyrillic setup / UTF8 unix locale\fR
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
\- \-transall \-maccodepage mac_cyrillic \-unixcodepage utf8
.fi
+.if n \{\
+.RE
+.\}
.PP
-\fBafpd.conf setup for Kerberos V auth\fR
-.PP
+\fBExample.\ \&afpd.conf setup for Kerberos V auth with newline escaping\fR
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
-\- \-transall \-uamlist uams_clrtxt.so,uams_dhx.so,uams_guest.so,uams_gss.so \\
-\-k5service afpserver \-k5keytab /path/to/afpserver.keytab \\
-\-k5realm YOUR.REALM \-fqdn your.fqdn.namel:548
+\- \-transall \-uamlist uams_dhx\&.so,uams_dhx2\&.so,uams_guest\&.so,uams_gss\&.so \e
+\-k5service afpserver \-k5keytab /path/to/afpserver\&.keytab \e
+\-k5realm YOUR\&.REALM \-fqdn your\&.fqdn\&.namel:548
.fi
+.if n \{\
+.RE
+.\}
.PP
-\fBafpd.conf letting afpd appear as three servers on the net\fR
-.PP
+\fBExample.\ \&afpd.conf letting afpd appear as three servers on the net\fR
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
-"Guest Server" \-uamlist uams_guest.so \-loginmesg "Welcome guest!"
-"User Server" \-uamlist uams_dhx.so \-port 12000
+"Guest Server" \-uamlist uams_guest\&.so \-loginmesg "Welcome guest!"
+"User Server" \-uamlist uams_dhx2\&.so \-port 12000
"special" \-notcp \-defaultvol <path> \-systemvol <path>
.fi
+.if n \{\
+.RE
+.\}
.SH "SEE ALSO"
-\fBafpd\fR(8), \fBafppasswd\fR(1), \fBAppleVolumes.default\fR(5)
-
+.PP
+\fBafpd\fR(8),
+\fBafppasswd\fR(1),
+\fBAppleVolumes.default\fR(5)
-.TH atalkd.conf 5 "22 September 2000" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: atalkd.conf
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 22 September 2000
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
+.\" Language: English
+.\"
+.TH "ATALKD\&.CONF" "5" "22 September 2000" "Netatalk 2.1beta" "Netatalk 2.1beta"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
atalkd.conf \- Configuration file used by atalkd(8) to determine the interfaces used by the master Netatalk daemon
-.SH DESCRIPTION
-\fI:ETCDIR:/atalkd.conf\fR is the
-configuration file used by atalkd to configure the Appletalk interfaces
-and their behavior
+.SH "DESCRIPTION"
.PP
-Any line not prefixed with \fI#\fR is
-interpreted. The configuration lines are composed like:
+\fB:ETCDIR:/atalkd\&.conf\fR
+is the configuration file used by atalkd to configure the Appletalk interfaces and their behavior
.PP
-\fIInterface\fR \fI[\fR \fIoptions\fR \fI]\fR
+Any line not prefixed with
+\fB#\fR
+is interpreted\&. The configuration lines are composed like:
.PP
-The simplest case is to have either no atalkd.conf, or to have one
-that has no active lines. In this case, atalkd should auto\-discover the
-local interfaces on the machine. Please note that you cannot split
-lines.
+\fIInterface\fR
+\fB[\fR
+\fIoptions\fR
+\fB]\fR
.PP
-The interface is the network interface that this to work over, such
-as \fIeth0\fR for Linux, or \fIle0\fR for Sun.
+The simplest case is to have either no atalkd\&.conf, or to have one that has no active lines\&. In this case, atalkd should auto\-discover the local interfaces on the machine\&. Please note that you cannot split lines\&.
+.PP
+The interface is the network interface that this to work over, such as
+\fBeth0\fR
+for Linux, or
+\fBle0\fR
+for Sun\&.
.PP
The possible options and their meanings are:
-.TP
-\fB\-addr \fInet.node\fB\fR
-Allows specification of the net and node numbers for this
-interface, specified in Appletalk numbering format (example:
-\fB\-addr 66.6\fR).
-.TP
+.PP
+\fB\-addr \fR\fB\fInet\&.node\fR\fR
+.RS 4
+Allows specification of the net and node numbers for this interface, specified in Appletalk numbering format (example:
+\fB\-addr 66\&.6\fR)\&.
+.RE
+.PP
\fB\-dontroute\fR
-Disables Appletalk routing. It is the opposite of
-\fB\-router\fR.
-.TP
+.RS 4
+Disables Appletalk routing\&. It is the opposite of
+\fB\-router\fR\&.
+.RE
+.PP
\fB\-net first[\-last]\fR
-Allows the available net to be set, optionally as a
-range.
-.TP
+.RS 4
+Allows the available net to be set, optionally as a range\&.
+.RE
+.PP
\fB\-noallmulti\fR (linux only)
-On linux the interfaces, atalkd uses, are set to
-ALLMULTI by default caused by countless NICs having problems
-without being forced into this mode (some even don't work with
-allmulti set). In case, you've a NIC known to support multicasts
-properly, you might want to set this option causing less packets to
-be processed
-.TP
+.RS 4
+On linux the interfaces, atalkd uses, are set to ALLMULTI by default caused by countless NICs having problems without being forced into this mode (some even don\'t work with allmulti set)\&. In case, you\'ve a NIC known to support multicasts properly, you might want to set this option causing less packets to be processed
+.RE
+.PP
\fB\-phase ( 1 | 2 )\fR
-Specifies the Appletalk phase that this interface is to use
-(either Phase 1 or Phase 2).
-.TP
+.RS 4
+Specifies the Appletalk phase that this interface is to use (either Phase 1 or Phase 2)\&.
+.RE
+.PP
\fB\-router\fR
-Like \fB\-seed\fR, but allows single interface
-routing. It is the opposite of \fB\-dontroute\fR.
-.TP
+.RS 4
+Like
+\fB\-seed\fR, but allows single interface routing\&. It is the opposite of
+\fB\-dontroute\fR\&.
+.RE
+.PP
\fB\-seed\fR
-The seed option only works if you have multiple interfaces. It
-also causes all missing arguments to be automagically configured
-from the network.
-.TP
-\fB\-zone \fIzonename\fB\fR
+.RS 4
+The seed option only works if you have multiple interfaces\&. It also causes all missing arguments to be automagically configured from the network\&.
+.RE
+.PP
+\fB\-zone \fR\fB\fIzonename\fR\fR
+.RS 4
Specifies a specific zone that this interface should appear on (example:
-\fB\-zone "Parking Lot"\fR). Please note that zones with
-spaces and other special characters should be enclosed in
-parentheses.
+\fB\-zone "Parking Lot"\fR)\&. Please note that zones with spaces and other special characters should be enclosed in parentheses\&.
+.RE
.SH "SEE ALSO"
+.PP
\fBatalkd\fR(8)
-
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
.\" Date: 9 Jun 2009
-.\" Manual: Netatalk 2.1
-.\" Source: Netatalk 2.1
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
.\" Language: English
.\"
-.TH "NETATALK\&.CONF" "5" "9 Jun 2009" "Netatalk 2\&.1" "Netatalk 2.1"
+.TH "NETATALK\&.CONF" "5" "9 Jun 2009" "Netatalk 2.1beta" "Netatalk 2.1beta"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
-.TH papd.conf 5 "06 Sep 2004" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: papd.conf
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 06 Sep 2004
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "PAPD\&.CONF" "5" "06 Sep 2004" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
papd.conf \- Configuration file used by papd(8) to determine the configuration of printers used by the Netatalk printing daemon
-.SH DESCRIPTION
-\fI:ETCDIR:/papd.conf\fR is the
-configuration file used by papd to configure the printing services offered
-by netatalk. Please note that papd must be enabled in \fI:ETCDIR:/netatalk.conf\fR for this to take any effect.
-\fIpapd\fR shares the same defaults as lpd on
-many systems, but not Solaris.
+.SH "DESCRIPTION"
.PP
-Any line not prefixed with \fI#\fR is
-interpreted. The configuration lines are composed like:
+\fB:ETCDIR:/papd\&.conf\fR
+is the configuration file used by papd to configure the printing services offered by netatalk\&. Please note that papd must be enabled in
+\fB:ETCDIR:/netatalk\&.conf\fR
+for this to take any effect\&.
+\fBpapd\fR
+shares the same defaults as lpd on many systems, but not Solaris\&.
+.PP
+Any line not prefixed with
+\fB#\fR
+is interpreted\&. The configuration lines are composed like:
.PP
\fIprintername:[options]\fR
.PP
-On systems running a System V printing system the simplest case is
-to have either no papd.conf, or to have one that has no active lines. In
-this case, atalkd should auto\-discover the local printers on the machine.
-Please note that you can split lines by using \fI\\\\fR.\fR
-.PP
-printername may be just a name (\fIPrinter
-1\fR), or it may be a full name in nbp_name format (\fIPrinter 1:LaserWriter@My Zone\fR).
-.PP
-Systems using a BSD printing system should make use of a pipe to the
-printing command in question within the \fIpr\fR
-option (eg. \fIpr=|/usr/bin/lpr \-J%J \-u%U\fR).
-Note: When printing using a pipe, papd recognizes several wildcards: %F
-will be replaced by the name present in the "%%For:" comment in the
-PostScript stream, same with %J for the "%%Title:" comment. %U will be
-substituted with the login name (the latter applies only when
-authenticated printing is in effect).
-.PP
-When CUPS support is compiled in, then \fIcupsautoadd \fRas the first entry in papd.conf will
-automagically share all CUPS printers by papd utilizing the PPDs assigned
-in CUPS (customizable \-\- see below). This can be overwritten for individal
-printers by subsequently adding individual entries using the CUPS queue
-name as \fIpr \fRentry. Note: CUPS support is
-mutually exclusive with System V support described above.
-.PP
-The possible options are colon delimited (\fI:\fR), and lines must be terminated with colons. The
-possible options and flags are:
-.TP
-\fIam=(uams list)\fR
-The \fIam\fR option allows specific
-UAMs to be specified for a particular printer. It has no effect if
-the \fIau\fR flag is not present or if papd
-authentication was not built into netatalk. Note: possible values
-are \fIuams_guest.so\fR and \fIuams_clrtxt.so\fR only. The first method requires
-a valid username, but no password. The second requires both a valid
-username and the correct password.
-.TP
-\fIau\fR
-If present, this flag enables authentication for the printer.
-Please note that papd authentication must be built into netatalk for
-this to take effect.
-.TP
-\fIco=(CUPS options)\fR
-The \fIco\fR option allows options to
-be passed through to CUPS (eg. \fIco="protocol=TBCP" \fRor \fIco="raw"\fR).
-.TP
-\fIcupsautoadd[:type][@zone]\fR
-If used as the first entry in papd.conf this will share all
-CUPS printers via papd. type/zone settings as well as other
-parameters assigned to this special printer share will apply to all
-CUPS printers. Unless the \fIpd\fR option
-is set, the CUPS PPDs will be used. To overwrite these global
-settings for individual printers simply add them subsequently to
-papd.conf and assign different settings.
-.TP
-\fIfo\fR
-If present, this flag enables a hack to translate line endings
-originating from pre Mac OS X LaserWriter drivers to let \fIfoomatic\-rip\fR recognize foomatic PPD options set
-in the printer dialog. Attention: Use with caution since this might
-corrupt binary print jobs!
-.TP
-\fIop=(operator)\fR
-This specifies the operator name, for lpd spooling.
-.TP
-\fIpa=(appletalk address)\fR
-Allows specification of Appletalk addresses. Usually not
-needed.
-.TP
-\fIpd=(path to ppd file)\fR
-Specifies a particular PPD (printer description file) to
-associate with the selected printer.
-.TP
-\fIpr=(lpd/CUPS printer name or pipe command)\fR
-Sets the \fIlpd\fR or \fICUPS\fR printer that this is spooled to.
-.SH EXAMPLES
-Unless CUPS support has been compiled in (which is default from
-Netatalk 2.0 on) one simply defines the lpd queue in question by setting
-the \fBpr\fR parameter to the queue name, in the following
-example "ps". If no \fBpr\fR parameter is set, the default
-printer will be used.
-.PP
-\fBpapd.conf System V printing system examples\fR
-.PP
-The first spooler is known by the AppleTalk name Mac Printer
-Spooler, and uses a PPD file located in
-\fB/usr/share/lib/ppd\fR. In addition, the user mcs will
-be the owner of all jobs that are spooled. The second spooler is known
-as HP Printer and all options are the default.
-
+On systems running a System V printing system the simplest case is to have either no papd\&.conf, or to have one that has no active lines\&. In this case, atalkd should auto\-discover the local printers on the machine\&. Please note that you can split lines by using
+\fB\e\efR\&.\fR
+.PP
+printername may be just a name (\fBPrinter 1\fR), or it may be a full name in nbp_name format (\fBPrinter 1:LaserWriter@My Zone\fR)\&.
+.PP
+Systems using a BSD printing system should make use of a pipe to the printing command in question within the
+\fBpr\fR
+option (eg\&.
+\fBpr=|/usr/bin/lpr\fR)\&.
+.PP
+When CUPS support is compiled in, then
+\fBcupsautoadd \fR
+as the first entry in papd\&.conf will automagically share all CUPS printers by papd utilizing the PPDs assigned in CUPS (customizable \-\- see below)\&. This can be overwritten for individal printers by subsequently adding individual entries using the CUPS queue name as
+\fBpr \fR
+entry\&. Note: CUPS support is mutually exclusive with System V support described above\&.
+.PP
+The possible options are colon delimited (\fB:\fR), and lines must be terminated with colons\&. The possible options and flags are:
+.PP
+\fBam=(uams list)\fR
+.RS 4
+The
+\fBam\fR
+option allows specific UAMs to be specified for a particular printer\&. It has no effect if the
+\fBau\fR
+flag is not present or if papd authentication was not built into netatalk\&. Note: possible values are
+\fBuams_guest\&.so\fR
+and
+\fB uams_clrtxt\&.so\fR
+only\&. The first method requires a valid username, but no password\&. The second requires both a valid username and the correct password\&.
+.RE
+.PP
+\fBau\fR
+.RS 4
+If present, this flag enables authentication for the printer\&. Please note that papd authentication must be built into netatalk for this to take effect\&.
+.RE
+.PP
+\fBco=(CUPS options)\fR
+.RS 4
+The
+\fBco\fR
+option allows options to be passed through to CUPS (eg\&.
+\fBco="protocol=TBCP" \fR
+or
+\fBco="raw"\fR)\&.
+.RE
+.PP
+\fBcupsautoadd[:type][@zone]\fR
+.RS 4
+If used as the first entry in papd\&.conf this will share all CUPS printers via papd\&. type/zone settings as well as other parameters assigned to this special printer share will apply to all CUPS printers\&. Unless the
+\fBpd\fR
+option is set, the CUPS PPDs will be used\&. To overwrite these global settings for individual printers simply add them subsequently to papd\&.conf and assign different settings\&.
+.RE
+.PP
+\fBfo\fR
+.RS 4
+If present, this flag enables a hack to translate line endings originating from pre Mac OS X LaserWriter drivers to let
+\fBfoomatic\-rip\fR
+recognize foomatic PPD options set in the printer dialog\&. Attention: Use with caution since this might corrupt binary print jobs!
+.RE
+.PP
+\fBop=(operator)\fR
+.RS 4
+This specifies the operator name, for lpd spooling\&.
+.RE
+.PP
+\fBpa=(appletalk address)\fR
+.RS 4
+Allows specification of Appletalk addresses\&. Usually not needed\&.
+.RE
+.PP
+\fBpd=(path to ppd file)\fR
+.RS 4
+Specifies a particular PPD (printer description file) to associate with the selected printer\&.
+.RE
+.PP
+\fBpr=(lpd/CUPS printer name or pipe command)\fR
+.RS 4
+Sets the
+\fBlpd\fR
+or
+\fBCUPS\fR
+printer that this is spooled to\&.
+.RE
+.SH "EXAMPLES"
+.PP
+Unless CUPS support has been compiled in (which is default from Netatalk 2\&.0 on) one simply defines the lpd queue in question by setting the
+\fBpr\fR
+parameter to the queue name, in the following example "ps"\&. If no
+\fBpr\fR
+parameter is set, the default printer will be used\&.
+.PP
+\fBExample.\ \&papd.conf System V printing system examples\fR
+.PP
+The first spooler is known by the AppleTalk name Mac Printer Spooler, and uses a PPD file located in
+/usr/share/lib/ppd\&. In addition, the user mcs will be the owner of all jobs that are spooled\&. The second spooler is known as HP Printer and all options are the default\&.
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
-Mac Printer Spooler:\\
- :pr=ps:\\
- :pd=/usr/share/lib/ppd/HPLJ_4M.PPD:\\
+Mac Printer Spooler:\e
+ :pr=ps:\e
+ :pd=/usr/share/lib/ppd/HPLJ_4M\&.PPD:\e
:op=mcs:
-HP Printer:\\
+HP Printer:\e
:
.fi
-.PP
-An alternative to the technique outlined above is to direct papd's
-output via a pipe into another program. Using this mechanism almost all
-printing systems can be driven. Netatalk supplies three "wildcards" that
-get substituted with values of the already printed job:
-\fB%F\fR, \fB%U\fR and \fB%J\fR. Using
-these wildcards, one can pass those parameters directly to programs or
-implement small wrapper scripts to call the printing system in
-question.
-.PP
-\fBpapd.conf examples using pipes\fR
-.PP
-The first spooler is known as HP 8100. It pipes the print job to
-/usr/bin/lpr for printing using the value of the
-\fI%%Title: \fRcomment as job name. PSSP authenticated
-printing is enabled, as is CAP\-style authenticated printing. Both
-methods support guest and cleartext authentication as specified by the
-\&'\fBam\fR' option. The PPD used is
-\fB/etc/atalk/ppds/hp8100.ppd\fR. The second spooler is
-called "Dump PostScript" and uses a pipe to cat to
-send the raw PostScript code into the user's home directory into a file
-called like the printjob.
+.if n \{\
+.RE
+.\}
+.PP
+An alternative to the technique outlined above is to direct papd\'s output via a pipe into another program\&. Using this mechanism almost all printing systems can be driven\&.
+.PP
+\fBExample.\ \&papd.conf examples using pipes\fR
+.PP
+The first spooler is known as HP 8100\&. It pipes the print job to
+\fB/usr/bin/lpr\fR
+for printing\&. PSSP authenticated printing is enabled, as is CAP\-style authenticated printing\&. Both methods support guest and cleartext authentication as specified by the \'\fBam\fR\' option\&. The PPD used is
+/etc/atalk/ppds/hp8100\&.ppd\&.
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
-HP 8100:\\
- :pr=|/usr/bin/lpr \-Plp \-J"%J":\\
- :sp:\\
- :ca=/tmp/print:\\
- :am=uams_guest.so,uams_pam.so:\\
- :pd=/etc/atalk/ppds/hp8100.ppd:
-
-Dump PostScript:LaserWriter@Server:\\
- :pr=|cat >/home/%U/%J\-prn.out:\\
- :pd=/usr/share/lib/ppd/mooralana.ppd:\\
- :sp:au:op=lp:\\
- :am=uams_clrtxt.so:
+HP 8100:\e
+ :pr=|/usr/bin/lpr \-Plp:\e
+ :sp:\e
+ :ca=/tmp/print:\e
+ :am=uams_guest\&.so,uams_pam\&.so:\e
+ :pd=/etc/atalk/ppds/hp8100\&.ppd:
+
.fi
-.PP
-Starting with Netatalk 2.0 direct CUPS integration is available. In
-this case, defining only a queue name as \fBpr\fR parameter
-won't invoke the SysV lpd daemon but uses CUPS instead. Unless a specific
-PPD has been assigned using the \fBpd\fR switch, the PPD
-configured in CUPS will be used by papd, too.
-.PP
-There exists one special share named "cupsautoadd". If this is
-present as the first entry then all available CUPS queues will be served
-automagically using the parameters assigned to this global share. But
-subsequent printer definitions can be used to override these global
-settings for individual spoolers.
-.PP
-\fBpapd.conf CUPS examples\fR
-.PP
-The first entry sets up automatic sharing of all CUPS printers.
-All those shares appear in the zone "1st floor" and since no additional
-settings have been made, they use the CUPS printer name as NBP name and
-use the PPD configured in CUPS. The second entry defines different
-settings for one single CUPS printer. It's NBP name is differing from
-the printer's name and the registration happens in another zone.
+.if n \{\
+.RE
+.\}
+.sp
+.PP
+Starting with Netatalk 2\&.0 direct CUPS integration is available\&. In this case, defining only a queue name as
+\fBpr\fR
+parameter won\'t invoke the SysV lpd daemon but uses CUPS instead\&. Unless a specific PPD has been assigned using the
+\fBpd\fR
+switch, the PPD configured in CUPS will be used by
+\fBpapd\fR, too\&.
+.PP
+There exists one special share named "cupsautoadd"\&. If this is present as the first entry then all available CUPS queues will be served automagically using the parameters assigned to this global share\&. But subsequent printer definitions can be used to override these global settings for individual spoolers\&.
+.PP
+\fBExample.\ \&papd.conf CUPS examples\fR
+.PP
+The first entry sets up automatic sharing of all CUPS printers\&. All those shares appear in the zone "1st floor" and since no additional settings have been made, they use the CUPS printer name as NBP name and use the PPD configured in CUPS\&. The second entry defines different settings for one single CUPS printer\&. It\'s NBP name is differing from the printer\'s name and the registration happens in another zone\&.
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
cupsautoadd@1st floor:op=root:
-Boss' LaserWriter@2nd floor:\\
+Boss\' LaserWriter@2nd floor:\e
:pr=laserwriter\-chief:
.fi
-.SH "SEE ALSO"
-\fBpapd\fR(8), \fBatalkd.conf\fR(5), \fBlpd\fR(8), \fBlpoptions\fR(8)
+.if n \{\
+.RE
+.\}
+.SH "SEE ALSO"
+.PP
+\fBpapd\fR(8),
+\fBatalkd.conf\fR(5),
+\fBlpd\fR(8),
+\fBlpoptions\fR(8)
+'\" t
.\" Title: afp_acls
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
-.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
-.\" Date: 31-01-2009
-.\" Manual: Netatalk 2.0 Manual
-.\" Source: :NETATALK_VERSION:
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 02 Feb 2009
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
.\" Language: English
.\"
-.TH "AFP_ACLS" "8" "31-01-2009" ":NETATALK_VERSION:" "Netatalk 2.0 Manual"
-.\" -----------------------------------------------------------------
-.\" * (re)Define some macros
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" BB/BE - put background/screen (filled box) around block of text
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de BB
-.if t \{\
-.sp -.5
-.br
-.in +2n
-.ll -2n
-.gcolor red
-.di BX
-.\}
-..
-.de EB
-.if t \{\
-.if "\\$2"adjust-for-leading-newline" \{\
-.sp -1
-.\}
-.br
-.di
-.in
-.ll
-.gcolor
-.nr BW \\n(.lu-\\n(.i
-.nr BH \\n(dn+.5v
-.ne \\n(BHu+.5v
-.ie "\\$2"adjust-for-leading-newline" \{\
-\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
-.\}
-.el \{\
-\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
-.\}
-.in 0
-.sp -.5v
-.nf
-.BX
-.in
-.sp .5v
-.fi
-.\}
-..
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" BM/EM - put colored marker in margin next to block of text
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de BM
-.if t \{\
-.br
-.ll -2n
-.gcolor red
-.di BX
-.\}
-..
-.de EM
-.if t \{\
-.br
-.di
-.ll
-.gcolor
-.nr BH \\n(dn
-.ne \\n(BHu
-\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
-.in 0
-.nf
-.BX
-.in
-.fi
-.\}
-..
+.TH "AFP_ACLS" "8" "02 Feb 2009" "Netatalk 2.1beta" "Netatalk 2.1beta"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
-.SH "Name"
+.SH "NAME"
afp_acls \- Setup and Usage Howto for ACLs with Netatalk
-.SH "Description"
+.SH "DESCRIPTION"
.PP
ACL support for AFP is implemented with NFSv4 ACLs\&. Few filesystems and fewer OSes support these\&. At the time of implementation its only provided with ZFS on Solaris, Opensolaris and derived distributions\&.
-.SH "Configuration"
+.SH "CONFIGURATION"
.PP
In order to be able to support ACLs, the following things have to be configured:
.sp
.if n \{\
.RS 4
.\}
-.fam C
-.ps -1
.nf
-.BB lightgray
aclinherit = passthrough
aclmode = passthrough
-.EB lightgray
.fi
-.fam
-.ps +1
.if n \{\
.RE
.\}
.sp
.\}
.RS 4
-.BM yellow
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
This however is not a strict requirement: if you create duplicates of every LDAP/OD user and group with identic attributes (name, uid, gid) in your local data store (/etc/[passwd|group]) ACLs will work
\fIas long as user/group names/ids in the filesystem are equal to their counterparts in the LDAP/OD datastore\fR\&.
.sp .5v
-.EM yellow
.RE
.RE
.sp
.sp -1
.IP \(bu 2.3
.\}
-configure Netatalk via ldap\&.conf so that Netatalk is able to retrieve the UUID for users and groups via LDAP search queries
+configure Netatalk via afp_ldap\&.conf so that Netatalk is able to retrieve the UUID for users and groups via LDAP search queries
.RE
.RE
.sp
-.TH afpd 8 "06 Jan 2004" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: afpd
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 06 Jan 2004
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
+.\" Language: English
+.\"
+.TH "AFPD" "8" "06 Jan 2004" "Netatalk 2.1beta" "Netatalk 2.1beta"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
afpd \- AppleTalk Filing Protocol daemon
-.SH SYNOPSIS
-\fBafpd\fR [\-duptDTvI] [\-f \fBdefaultvolumes\fR] [\-s \fBsystemvolumes\fR] [\-n \fBnbpname\fR] [\-c \fBmaxconnections\fR] [\-g \fBguest\fR] [\-P \fBpidfile\fR] [\-S \fBport\fR] [\-L \fBmessage\fR] [\-F \fBconfig\fR] [\-U \fBuamsv\fR] [\-m \fBumask\fR]
-.SH DESCRIPTION
-afpd provides an AppleTalk Filing Protocol (AFP)
-interface to the Unix file system. It is normally started at boot time
-from /etc/rc.
+.SH "SYNOPSIS"
+.HP \w'\fBafpd\fR\fB\fR\ 'u
+\fBafpd\fR\fB\fR [\-duptDTvI] [\-f\ \fIdefaultvolumes\fR] [\-s\ \fIsystemvolumes\fR] [\-n\ \fInbpname\fR] [\-c\ \fImaxconnections\fR] [\-g\ \fIguest\fR] [\-P\ \fIpidfile\fR] [\-S\ \fIport\fR] [\-L\ \fImessage\fR] [\-F\ \fIconfig\fR] [\-U\ \fIuamsv\fR] [\-m\ \fIumask\fR]
+.SH "DESCRIPTION"
+.PP
+\fBafpd\fR
+provides an AppleTalk Filing Protocol (AFP) interface to the Unix file system\&. It is normally started at boot time from /etc/rc\&.
.PP
The list of volumes offered to the user is generated from
-\fB:ETCDIR:/AppleVolumes.system\fR and one of
-\fB:ETCDIR:/AppleVolumes.default\fR, \fB~/AppleVolumes\fR,
-or \fB~/.AppleVolumes\fR. The \fBAppleVolumes\fR
-files is used to specify volumes to mount and file name extension
-mappings. It is formatted as follows, one specification per line: pathname
-[ volumename ] .extension [ type [ creator ] ] If volumename is
-unspecified, the last component of pathname is used. No two volumes may
-have the same name. If type is unspecified '????' is used. If
-creator is unspecified 'UNIX' is used. The extension '.'
-sets the default creator and type for otherwise untyped Unix files. Blank
-lines and lines beginning with `#' are ignored.
-.PP
-.SH OPTIONS
-.TP
+:ETCDIR:/AppleVolumes\&.system
+and one of
+:ETCDIR:/AppleVolumes\&.default,
+~/AppleVolumes, or
+~/\&.AppleVolumes\&. The
+AppleVolumes
+files is used to specify volumes to mount and file name extension mappings\&. It is formatted as follows, one specification per line: pathname [ volumename ] \&.extension [ type [ creator ] ] If volumename is unspecified, the last component of pathname is used\&. No two volumes may have the same name\&. If type is unspecified \'????\' is used\&. If creator is unspecified \'UNIX\' is used\&. The extension \'\&.\' sets the default creator and type for otherwise untyped Unix files\&. Blank lines and lines beginning with `#\' are ignored\&.
+.PP
+.SH "OPTIONS"
+.PP
\-d
-Specifies that the daemon should not fork. If netatalk has been
-configured with \fI\-\-enable\-debug1\fR, a trace of
-all AFP commands will be written to stdout.
-.TP
+.RS 4
+Specifies that the daemon should not fork\&. If netatalk has been configured with
+\fI\-\-enable\-debug1\fR, a trace of all AFP commands will be written to stdout\&.
+.RE
+.PP
\-p
-Prevents clients from saving their passwords. (Equivalent to \-\fBnosavepasswd\fR
-in \fBafpd.conf\fR.)
-.TP
+.RS 4
+Prevents clients from saving their passwords\&. (Equivalent to \-\fBnosavepasswd\fR
+in
+afpd\&.conf\&.)
+.RE
+.PP
\-t
-Allows clients to change their passwords. (Equivalent to
-\fB\-setpasswd\fR in \fBafpd.conf\fR.)
-.TP
+.RS 4
+Allows clients to change their passwords\&. (Equivalent to
+\fB\-setpasswd\fR
+in
+afpd\&.conf\&.)
+.RE
+.PP
\-D
-Use DDP (AppleTalk) as transport protocol. (Equivalent to
-\fB\-ddp\fR in \fBafpd.cond\fR.)
-.TP
+.RS 4
+Use DDP (AppleTalk) as transport protocol\&. (Equivalent to
+\fB\-ddp\fR
+in
+afpd\&.cond\&.)
+.RE
+.PP
\-T
-Use TCP/IP as transport protocol. (Equivalent to
-\fB\-tcp\fR in \fBafpd.conf\fR.)
-.TP
+.RS 4
+Use TCP/IP as transport protocol\&. (Equivalent to
+\fB\-tcp\fR
+in
+afpd\&.conf\&.)
+.RE
+.PP
\-v
-Print version information and exit.
-.TP
+.RS 4
+Print version information and exit\&.
+.RE
+.PP
\-I
-Use a platform specific icon. (Equivalent to \fB\-icon\fR
-in \fBafpd.conf\fR.)
-.TP
+.RS 4
+Use a platform specific icon\&. (Equivalent to
+\fB\-icon\fR
+in
+afpd\&.conf\&.)
+.RE
+.PP
\-f \fIdefaultvolumes\fR
-Specifies that \fIdefaultvolumes\fR
+.RS 4
+Specifies that
+\fIdefaultvolumes\fR
should be read for a list of default volumes to offer, instead of
-\fB:ETCDIR:/AppleVolumes.default\fR.
-.TP
+:ETCDIR:/AppleVolumes\&.default\&.
+.RE
+.PP
\-s \fIsystemvolumes\fR
-Specifies that \fIsystemvolumes\fR should
-be read for a list of volume that all users will be offered, instead
-of \fB:ETCDIR:/AppleVolumes.system\fR.
-.TP
+.RS 4
+Specifies that
+\fIsystemvolumes\fR
+should be read for a list of volume that all users will be offered, instead of
+:ETCDIR:/AppleVolumes\&.system\&.
+.RE
+.PP
\-u
-Read the user's \fBAppleVolumes\fR file
-first. This option causes volume names in the user's
-\fBAppleVolumes\fR file to override volume names in
-the system's \fBAppleVolumes\fR file. The default
-is to read the system \fBAppleVolumes\fR file first.
-Note that this option doesn't effect the precendence of filename
-extension mappings: the user's \fBAppleVolumes\fR
-file always has precedence.
-.TP
+.RS 4
+Read the user\'s
+AppleVolumes
+file first\&. This option causes volume names in the user\'s
+AppleVolumes
+file to override volume names in the system\'s
+AppleVolumes
+file\&. The default is to read the system
+AppleVolumes
+file first\&. Note that this option doesn\'t effect the precendence of filename extension mappings: the user\'s
+AppleVolumes
+file always has precedence\&.
+.RE
+.PP
\-n \fInbpname\fR
-Specifies that \fInbpname\fR should be
-used for NBP registration, instead of the first component of the
-hostname in the local zone.
-.TP
+.RS 4
+Specifies that
+\fInbpname\fR
+should be used for NBP registration, instead of the first component of the hostname in the local zone\&.
+.RE
+.PP
\-c \fImaxconnections\fR
+.RS 4
Specifies the maximum number of connections to allow for this
-afpd. The default is 20.
-.TP
+\fBafpd\fR\&. The default is 20\&.
+.RE
+.PP
\-g \fIguest\fR
-Specifies the name of the guest account. The default is
-\&'\fInobody\fR'.
-.TP
+.RS 4
+Specifies the name of the guest account\&. The default is \'\fInobody\fR\'\&.
+.RE
+.PP
\-P \fIpidfile\fR
-Specifies the file in which afpd stores its
-process id.
-.TP
+.RS 4
+Specifies the file in which
+\fBafpd\fR
+stores its process id\&.
+.RE
+.PP
\-S \fIport\fR
-Specifies the port to register with when doing AFPoverTCP.
-Defaults to 548. (Equivalent to \fB\-port \fRin
-\fBafpd.conf\fR.)
-.TP
+.RS 4
+Specifies the port to register with when doing AFPoverTCP\&. Defaults to 548\&. (Equivalent to
+\fB\-port \fRin
+afpd\&.conf\&.)
+.RE
+.PP
\-L \fImessage\fR
-Specifies the login message that will be sent to clients.
-(Equivalent to \fB\-loginmsg\fR in \fBafpd.conf\fR.)
-.TP
+.RS 4
+Specifies the login message that will be sent to clients\&. (Equivalent to
+\fB\-loginmsg\fR
+in
+afpd\&.conf\&.)
+.RE
+.PP
\-F \fIconfigfile\fR
-Specifies the configuration file to use. (Defaults to
-\fB:ETCDIR:/netatalk/afpd.conf\fR.)
-.TP
+.RS 4
+Specifies the configuration file to use\&. (Defaults to
+:ETCDIR:/netatalk/afpd\&.conf\&.)
+.RE
+.PP
\-U \fIuams\fR
-Comma\-separated list of UAMs to use for the authentication
-process. (Equivalent to \fB\-uamlist\fR in
-\fBafpd.conf\fR.)
-.TP
+.RS 4
+Comma\-separated list of UAMs to use for the authentication process\&. (Equivalent to
+\fB\-uamlist\fR
+in
+afpd\&.conf\&.)
+.RE
+.PP
\-m \fIumask\fR
-Use this umask for the creation of
-folders in Netatalk.
-.SH SIGNALS
-Signals that are sent to the main afpd process
-are propagated to the children, so all will be affected.
-.TP
+.RS 4
+Use this
+\fIumask\fR
+for the creation of folders in Netatalk\&.
+.RE
+.SH "SIGNALS"
+.PP
+Signals that are sent to the main
+\fBafpd\fR
+process are propagated to the children, so all will be affected\&.
+.PP
SIGHUP
-Sending a SIGHUP to afpd will cause it to
-reload its configuration files.
-.TP
+.RS 4
+Sending a
+\fBSIGHUP\fR
+to afpd will cause it to reload its configuration files\&.
+.RE
+.PP
SIGUSR1
-The afpd process will send the message
-"The server is going down for maintenance." to the client
-and shut itself down in 5 minutes. New connections are not allowed.
-If this is sent to a child afpd, the other children are not
-affected. However, the main process will still exit, disabling all
-new connections.
-.TP
+.RS 4
+The
+\fBafpd\fR
+process will send the message "The server is going down for maintenance\&." to the client and shut itself down in 5 minutes\&. New connections are not allowed\&. If this is sent to a child afpd, the other children are not affected\&. However, the main process will still exit, disabling all new connections\&.
+.RE
+.PP
SIGUSR2
-The afpd process will look in the message
-directory configured at build time for a file named message.pid. For
-each one found, a the contents will be sent as a message to the
-associated AFP client. The file is removed after the message is
-sent. This should only be sent to a child afpd.
-Warning: If the \-\-with\-message\-dir option was not used, this will
-kill the afpd process
-
-To shut down a user's afpd process it
-is recommended that SIGKILL (\-9)
-\fINOT\fR be used, except as a last resort, as this
-may leave the CNID database in an inconsistent state. The safe way
-to terminate an afpd is to send it a
-SIGTERM (\-15) signal and wait for it to die on
-its own.
-.SH FILES
-.TP
-\fB:ETCDIR:/AppleVolumes.default\fR
+.RS 4
+The
+\fBafpd\fR
+process will look in the message directory configured at build time for a file named message\&.pid\&. For each one found, a the contents will be sent as a message to the associated AFP client\&. The file is removed after the message is sent\&. This should only be sent to a child
+\fBafpd\fR\&. Warning: If the \-\-with\-message\-dir option was not used, this will kill the
+\fBafpd\fR
+process
+.sp
+To shut down a user\'s
+\fBafpd\fR
+process it is recommended that
+\fBSIGKILL (\-9)\fR
+\fINOT\fR
+be used, except as a last resort, as this may leave the CNID database in an inconsistent state\&. The safe way to terminate an
+\fBafpd\fR
+is to send it a
+\fBSIGTERM (\-15)\fR
+signal and wait for it to die on its own\&.
+.RE
+.SH "FILES"
+.PP
+:ETCDIR:/AppleVolumes\&.default
+.RS 4
list of default volumes to mount
-.TP
-\fB:ETCDIR:/AppleVolumes.system\fR
+.RE
+.PP
+:ETCDIR:/AppleVolumes\&.system
+.RS 4
list of volumes to offer all users
-.TP
-\fB~/AppleVolumes\fR
-user's list of volumes to mount
-.TP
-\fB:ETCDIR:/netatalk/msg/message.pid\fR
-contains messages to be sent to users.
-.SH BUGS
+.RE
+.PP
+~/AppleVolumes
+.RS 4
+user\'s list of volumes to mount
+.RE
+.PP
+:ETCDIR:/netatalk/msg/message\&.pid
+.RS 4
+contains messages to be sent to users\&.
+.RE
+.SH "BUGS"
+.PP
.SH "SEE ALSO"
+.PP
\fBhosts_access\fR(5),
\fBafpd.conf\fR(5),
\fBAppleVolumes.default\fR(5),
-\fBAppleVolumes.system\fR(5).
-
+\fBAppleVolumes.system\fR(5),
+\fBdbd\fR(1)\&.
-.TH atalkd 8 "06 Sep 2004" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: atalkd
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 06 Sep 2004
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
+.\" Language: English
+.\"
+.TH "ATALKD" "8" "06 Sep 2004" "Netatalk 2.1beta" "Netatalk 2.1beta"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
atalkd \- AppleTalk RTMP, NBP, ZIP, and AEP manager
-.SH SYNOPSIS
-\fBatalkd\fR [\-f \fBconfigfile\fR] [\-1] [\-2]
-.SH DESCRIPTION
-atalkd is responsible for all user level
-AppleTalk network management. This includes routing, name registration and
-lookup, zone lookup, and the AppleTalk Echo Protocol (similar to
-\fBping\fR(8)). atalkd is typically started at boot
-time, out of \fB/etc/rc\fR. It first reads from its
-configuration file, \fB:ETCDIR:/atalkd.conf\fR. If there is
-no configuration file, atalkd will attempt to configure
-all available interfaces and will create a configuration file. The file
-consists of a series of interfaces, one per line. Lines with `#' in the
-first column are ignored, as are blank lines. The syntax is
+.SH "SYNOPSIS"
+.HP \w'\fBatalkd\fR\fB\fR\fB\fR\fB\fR\fB\fR\fB\fR\fB\fR\ 'u
+\fBatalkd\fR\fB\fR\fB\fR\fB\fR\fB\fR\fB\fR\fB\fR [\-f\ \fIconfigfile\fR] [\-1] [\-2]
+.SH "DESCRIPTION"
.PP
-\fIinterface\fR [ \fB\-seed\fR ]
-[ \fB\-phase\fR \fInumber\fR ] [
-\fB\-net\fR \fInet\-range\fR ] [
-\fB\-addr\fR \fIaddress\fR ] [
-\fB\-zone\fR \fIzonename\fR ] ...
+\fBatalkd\fR
+is responsible for all user level AppleTalk network management\&. This includes routing, name registration and lookup, zone lookup, and the AppleTalk Echo Protocol (similar to
+\fBping\fR(8))\&.
+\fBatalkd\fR
+is typically started at boot time, out of
+/etc/rc\&. It first reads from its configuration file,
+:ETCDIR:/atalkd\&.conf\&. If there is no configuration file,
+\fBatalkd\fR
+will attempt to configure all available interfaces and will create a configuration file\&. The file consists of a series of interfaces, one per line\&. Lines with `#\' in the first column are ignored, as are blank lines\&. The syntax is
.PP
-Note that all fields except the interface are optional. The loopback
-interface is configured automatically. If \fB\-seed\fR is
-specified, all other fields must be present. Also,
-atalkd will exit during bootstrap\%ping, if a router
-disagrees with its seed information. If \fB\-seed\fR is not
-given, all other information may be overriden during auto\-configuration.
-If no \fB\-phase\fR option is given, the default phase as given
-on the command line is used (the default is 2). If \fB\-addr\fR
-is given and \fB\-net\fR is not, a net\-range of one is
-assumed.
+\fIinterface\fR
+[
+\fB\-seed\fR
+] [
+\fB\-phase\fR
+\fInumber\fR
+] [
+\fB\-net\fR
+\fInet\-range\fR
+] [
+\fB\-addr\fR
+\fIaddress\fR
+] [
+\fB\-zone\fR
+\fIzonename\fR
+] \&.\&.\&.
.PP
-The first \-zone directive for each interface is the ``default''
-zone. Under Phase 1, there is only one zone. Under Phase 2, all routers on
-the network are configured with the default zone and must agree.
-atalkd maps ``*'' to the default zone of the first
-interface. Note: The default zone for a machine is determined by the
-configuration of the local routers; to appear in a non\-default zone, each
-service, e.g. afpd, must individually specify the
-desired zone. See also \fBnbp_name\fR(3).
-.SH ROUTING
-If you are connecting a netatalk router to an existing AppleTalk
-internet, you should first contact your local network administrators to
-obtain appropriate network addresses.
+Note that all fields except the interface are optional\&. The loopback interface is configured automatically\&. If
+\fB\-seed\fR
+is specified, all other fields must be present\&. Also,
+\fBatalkd\fR
+will exit during bootstrap\%ping, if a router disagrees with its seed information\&. If
+\fB\-seed\fR
+is not given, all other information may be overriden during auto\-configuration\&. If no
+\fB\-phase\fR
+option is given, the default phase as given on the command line is used (the default is 2)\&. If
+\fB\-addr\fR
+is given and
+\fB\-net\fR
+is not, a net\-range of one is assumed\&.
.PP
-atalkd can provide routing between interfaces by
-configuring multiple interfaces. Each interface must be assigned a unique
-net\-range between 1 and 65279 (0 and 65535 are illegal, and addresses
-between 65280 and 65534 are reserved for startup). It is best to choose
-the smallest useful net\-range, i.e. if you have three machines on an
-Ethernet, don't chose a net\-range of 1000\-2000. Each net\-range may have an
-arbitrary list of zones associated with it.
-.SH EXAMPLES
-Below is an example configuration file for a sun4/40. The machine
-has two interfaces, ``le0'' and ``le1''. The ``le0'' interface is
-configured automatically from other routers on the network. The machine is
-the only router for the ``le1'' interface.
+The first \-zone directive for each interface is the ``default\'\' zone\&. Under Phase 1, there is only one zone\&. Under Phase 2, all routers on the network are configured with the default zone and must agree\&.
+\fBatalkd\fR
+maps ``*\'\' to the default zone of the first interface\&. Note: The default zone for a machine is determined by the configuration of the local routers; to appear in a non\-default zone, each service, e\&.g\&.
+\fBafpd\fR, must individually specify the desired zone\&. See also
+\fBnbp_name\fR(3)\&.
+.SH "ROUTING"
.PP
+If you are connecting a netatalk router to an existing AppleTalk internet, you should first contact your local network administrators to obtain appropriate network addresses\&.
+.PP
+\fBatalkd\fR
+can provide routing between interfaces by configuring multiple interfaces\&. Each interface must be assigned a unique net\-range
+between 1 and 65279 (0 and 65535 are illegal, and addresses between 65280 and 65534 are reserved for startup)\&. It is best to choose the smallest useful net\-range, i\&.e\&. if you have three machines on an Ethernet, don\'t chose a net\-range of 1000\-2000\&. Each net\-range may have an arbitrary list of zones associated with it\&.
+.SH "EXAMPLES"
+.PP
+Below is an example configuration file for a sun4/40\&. The machine has two interfaces, ``le0\'\' and ``le1\'\'\&. The ``le0\'\' interface is configured automatically from other routers on the network\&. The machine is the only router for the ``le1\'\' interface\&.
+.PP
+.if n \{\
+.RS 4
+.\}
.nf
le0
le1 \-seed \-net 9461\-9471 \-zone netatalk \-zone Argus
.fi
-
-atalkd
-automatically acts as a router if there is more than one interface.
-.SH FILES
-\fB:ETCDIR:/atalkd.conf\fR configuration file
-.SH BUGS
-On some systems, atalkd can not be
-restarted.
+.if n \{\
+.RE
+.\}
+.sp
+\fBatalkd\fR
+automatically acts as a router if there is more than one interface\&.
+.SH "FILES"
+.PP
+:ETCDIR:/atalkd\&.conf
+configuration file
+.SH "BUGS"
+.PP
+On some systems,
+\fBatalkd\fR
+can not be restarted\&.
.SH "SEE ALSO"
+.PP
\fBatalkd.conf\fR(5)
-
-.TH cnid_dbd 8 "2 Dec 2003" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: cnid_dbd
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 21 Mar 2009
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
+.\" Language: English
+.\"
+.TH "CNID_DBD" "8" "21 Mar 2009" "Netatalk 2.1beta" "Netatalk 2.1beta"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
cnid_dbd \- implement access to CNID databases through a dedicated daemon process
-.SH SYNOPSIS
-\fBcnid_dbd\fR \fBdbdir\fR \fBctrlfd\fR \fBclntfd\fR
-.SH DESCRIPTION
-cnid_dbd provides an interface for storage and
-retrieval of catalog node IDs (CNIDs) and related information to the
-\fIafpd\fR daemon. CNIDs are a component of
-Macintosh based file systems with semantics that map not easily onto Unix
-file systems. This makes separate storage in a database necessary.
-cnid_dbd is part of the \fICNID
-backend\fR framework of \fIafpd\fR and
-implements the \fIdbd\fR backend.
-.PP
-cnid_dbd is never started via the command line or
-system startup scripts but only by the \fIcnid_metad\fR daemon. There is at most one instance of
-cnid_dbd per netatalk volume.
-.PP
-cnid_dbd uses the \fIBerkleley
-DB\fR database library and optionally supports transactionally
-protected updates if the netatalk package is compiled with the appropriate
-options. Using the \fIdbd\fR backend without
-transactions will protect the CNID database against unexpected crashes of
-the \fIafpd\fR daemon. Using the \fIdbd\fR backend with transactions will avoid corruption
-of the CNID database even if the system crashes unexpectedly.
-.PP
-cnid_dbd uses the same on\-disk database format as
-the \fIcdb\fR backend. It is therefore possible
-to switch between the two backends as necessary.
-.PP
-cnid_dbd inherits the effective userid and
-groupid from \fIcnid_metad\fR on startup, which
-is normally caused by \fIafpd\fR serving a
-netatalk volume to a client. It changes to the \fIBerkleley DB\fR database home directory \fIdbdir\fR that is associated with the volume. If the
-userid inherited from \fIcnid_metad\fR is 0
-(root), cnid_dbd will change userid and groupid to the
-owner and group of the database home directory. Otherwise, it will
-continue to use the inherited values. cnid_dbd will
-then attempt to open the database and start serving requests using
-filedescriptor \fIclntfd\fR. Subsequent instances
-of \fIafpd\fR that want to access the same volume
-are redirected to the running cnid_dbd process by
-\fIcnid_metad\fR via the filedescriptor \fIctrlfd\fR.
-.PP
-cnid_dbd can be configured to run forever or to
-exit after a period of inactivity. If cnid_dbd receives
-a TERM or an INT signal it will exit cleanly after flushing dirty database
-buffers to disk and closing \fIBerkleley DB\fR
-database environments. It is safe to terminate cnid_dbd
-this way, it will be restarted when necessary. Other signals are not
-handled and will cause an immediate exit, possibly leaving the CNID
-database in an inconsistent state (no transactions) or losing recent
-updates during recovery (transactions).
-.PP
-If transactions are used the \fIBerkleley
-DB\fR database subsystem will create files named log.xxxxxxxxxx in
-the database home directory \fIdbdir\fR, where
-xxxxxxxxxx is a monotonically increasing integer. These files contain
-information to replay database changes and are not automatically removed,
-unless the \fIlogfile_autoremove\fR option is
-specified in the \fIdb_param\fR configuration
-file (see below). Please see the sections \fIDatabase and
-log file archival\fR, \fILog file
-removal\fR and the documentation of the \fI
-db_archive\fR command line utility in the Berkeley DB Tutorial and
-Reference for information when and how it is safe to remove these files
-manually.
-.PP
-Do not use cnid_dbd for databases on
-NFS mounted file systems. It makes the whole point of securing
-database changes properly moot. Use the dbdir: Option in the appropriate
-\fIAppleVolumes\fR configuration file to put the
-database onto a local disk.
-.SH CONFIGURATION
-cnid_dbd reads configuration information from the
-file \fIdb_param\fR in the database directory
-\fIdbdir\fR on startup. If the file does not
-exist or a parameter is not listed, suitable default values are used. The
-format for a single parameter is the parameter name, followed by one or
-more spaces, followed by the parameter value, followed by a newline. The
-following parameters are currently recognized:
-.TP
-\fIlogfile_autoremove\fR
-This flag is ignored unless transactional support is enabled.
-If set to 1, unused Berkeley DB transactional logfiles
-(log.xxxxxxxxxx in the database home directory) are removed on
-startup of cnid_dbd. This is usually safe if the
-content of the database directory is backed up on a regular basis.
-Default: 0.
-.TP
-\fIcachesize\fR
-Determines the size of the Berkeley DB cache in kilobytes.
-Default: 1024. Each cnid_dbd process grabs that
-much memory on top of its normal memory footprint. It can be used to
-tune database performance. The \fIdb_stat\fR utility with the \fB\-m\fR
-option that comes with Berkely DB can help you determine wether you
-need to change this value. The default is pretty conservative so
-that a large percentage of requests should be satisfied from the
-cache directly. If memory is not a bottleneck on your system you
-might want to leave it at that value. The \fIBerkeley DB Tutorial and Reference Guide\fR has a
-section \fISelecting a cache size\fR that
-gives more detailed information.
-.TP
-\fInosync\fR
-This flag is ignored unless transactional support is enabled.
-If it is set to 1, transactional changes to the database are not
-synchronously written to disk when the transaction completes. This
-will increase performance considerably at the risk of recent changes
-getting lost in case of a crash. The database will still be
-consistent, though. See \fITransaction
-Throughput\fR in the Berkeley DB Tutorial for more
-information. Default: 0.
-.TP
-\fIflush_frequency\fR, \fIflush_interval\fR
-\fIflush_frequency\fR (Default: 100)
-and \fIflush_interval\fR (Default: 30)
-control how often changes to the database are written to the
-underlying database files if no transactions are used or how often
-the transaction system is checkpointed for transactions. Both of
-these operations are performed if either i) more than \fIflush_frequency\fR requests have been received or
-ii) more than \fIflush_interval\fR seconds
-have elapsed since the last save/checkpoint. If you use transactions
-with \fInosync\fR set to zero these
-parameters only influence how long recovery takes after a crash,
-there should never be any lost data. If \fInosync\fR is 1, changes might be lost, but only
-since the last checkpoint. Be careful to check your harddisk
-configuration for on disk cache settings. Many IDE disks just cache
-writes as the default behaviour, so even flushing database files to
-disk will not have the desired effect.
-.TP
-\fIfd_table_size\fR
-is the maximum number of connections (filedescriptors) that
-can be open for \fIafpd\fR client processes
-in \fIcnid_dbd.\fR Default: 16. If this
-number is exceeded, one of the existing connections is closed and
-reused. The affected \fIafpd\fR process
-will transparently reconnect later, which causes slight overhead. On
-the other hand, setting this parameter too high could affect
-performance in cnid_dbd since all descriptors
-have to be checked in a select() system call,
-or worse, you might exceed the per process limit of open file
-descriptors on your system. It is safe to set the value to 1 on
-volumes where only one \fIafpd\fR client
-process is expected to run, e.g. home directories.
-.TP
-\fIidle_timeout\fR
+.SH "SYNOPSIS"
+.HP \w'\fBcnid_dbd\fR\fB\fR\fB\fR\fB\fR\ 'u
+\fBcnid_dbd\fR\fB\fR\fB\fR\fB\fR \fIdbdir\fR \fIctrlfd\fR \fIclntfd\fR \fIlogconfig_string\fR
+.SH "DESCRIPTION"
+.PP
+\fBcnid_dbd\fR
+provides an interface for storage and retrieval of catalog node IDs (CNIDs) and related information to the
+\fBafpd\fR
+daemon\&. CNIDs are a component of Macintosh based file systems with semantics that map not easily onto Unix file systems\&. This makes separate storage in a database necessary\&.
+\fBcnid_dbd\fR
+is part of the
+\fBCNID backend\fR
+framework of
+\fBafpd\fR
+and implements the
+\fBdbd\fR
+backend\&.
+.PP
+\fBcnid_dbd\fR
+is never started via the command line or system startup scripts but only by the
+\fBcnid_metad\fR
+daemon\&. There is at most one instance of
+\fBcnid_dbd\fR
+per netatalk volume\&.
+.PP
+\fBcnid_dbd\fR
+uses the
+\fBBerkleley DB\fR
+database library and uses transactionally protected updates\&. The
+\fBdbd\fR
+backend with transactions will avoid corruption of the CNID database even if the system crashes unexpectedly\&.
+.PP
+\fBcnid_dbd\fR
+uses the same on\-disk database format as the
+\fBcdb\fR
+backend\&. It is therefore possible to switch between the two backends as necessary\&.
+.PP
+\fBcnid_dbd\fR
+inherits the effective userid and groupid from
+\fBcnid_metad\fR
+on startup, which is normally caused by
+\fBafpd\fR
+serving a netatalk volume to a client\&. It changes to the
+\fBBerkleley DB\fR
+database home directory
+\fIdbdir\fR
+that is associated with the volume\&. If the userid inherited from
+\fBcnid_metad\fR
+is 0 (root),
+\fBcnid_dbd\fR
+will change userid and groupid to the owner and group of the database home directory\&. Otherwise, it will continue to use the inherited values\&.
+\fBcnid_dbd\fR
+will then attempt to open the database and start serving requests using filedescriptor
+\fIclntfd\fR\&. Subsequent instances of
+\fBafpd\fR
+that want to access the same volume are redirected to the running
+\fBcnid_dbd\fR
+process by
+\fBcnid_metad\fR
+via the filedescriptor
+\fIctrlfd\fR\&.
+.PP
+\fBcnid_dbd\fR
+uses
+\fBlogconfig_string\fR
+which is passed from
+\fBcnid_metad\fR
+to configure its logging output\&.
+.PP
+\fBcnid_dbd\fR
+can be configured to run forever or to exit after a period of inactivity\&. If
+\fBcnid_dbd\fR
+receives a TERM or an INT signal it will exit cleanly after flushing dirty database buffers to disk and closing
+\fBBerkleley DB\fR
+database environments\&. It is safe to terminate
+\fBcnid_dbd\fR
+this way, it will be restarted when necessary\&. Other signals are not handled and will cause an immediate exit, possibly leaving the CNID database in an inconsistent state (no transactions) or losing recent updates during recovery (transactions)\&.
+.PP
+The
+\fBBerkleley DB\fR
+database subsystem will create files named log\&.xxxxxxxxxx in the database home directory
+\fIdbdir\fR, where xxxxxxxxxx is a monotonically increasing integer\&. These files contain ithe transactional database changes\&. They will be removed regularily, unless the
+\fBlogfile_autoremove\fR
+option is specified in the
+\fIdb_param\fR
+configuration file (see below)\&.
+.PP
+Do not use
+\fBcnid_dbd\fR
+for databases on NFS mounted file systems\&. It makes the whole point of securing database changes properly moot\&. Use the dbdir: Option in the appropriate
+\fBAppleVolumes\fR
+configuration file to put the database onto a local disk\&.
+.SH "CONFIGURATION"
+.PP
+\fBcnid_dbd\fR
+reads configuration information from the file
+\fIdb_param\fR
+in the database directory
+\fIdbdir\fR
+on startup\&. If the file does not exist or a parameter is not listed, suitable default values are used\&. The format for a single parameter is the parameter name, followed by one or more spaces, followed by the parameter value, followed by a newline\&. The following parameters are currently recognized:
+.PP
+\fBlogfile_autoremove\fR
+.RS 4
+If set to 0, unused Berkeley DB transactional logfiles (log\&.xxxxxxxxxx in the database home directory) are not removed on startup of
+\fBcnid_dbd\fR
+and on a reqular basis\&. Default: 1\&.
+.RE
+.PP
+\fBcachesize\fR
+.RS 4
+Determines the size of the Berkeley DB cache in kilobytes\&. Default: 8192\&. Each
+\fBcnid_dbd\fR
+process grabs that much memory on top of its normal memory footprint\&. It can be used to tune database performance\&. The
+\fBdb_stat\fR
+utility with the
+\fB\-m\fR
+option that comes with Berkely DB can help you determine wether you need to change this value\&. The default is pretty conservative so that a large percentage of requests should be satisfied from the cache directly\&. If memory is not a bottleneck on your system you might want to leave it at that value\&. The
+\fBBerkeley DB Tutorial and Reference Guide\fR
+has a section
+\fBSelecting a cache size\fR
+that gives more detailed information\&.
+.RE
+.PP
+\fBflush_frequency\fR, \fBflush_interval\fR
+.RS 4
+\fIflush_frequency\fR
+(Default: 1000) and
+\fIflush_interval\fR
+(Default: 1800) control how often changes to the database are checkpointed\&. Both of these operations are performed if either i) more than
+\fIflush_frequency\fR
+requests have been received or ii) more than
+\fIflush_interval\fR
+seconds have elapsed since the last save/checkpoint\&. Be careful to check your harddisk configuration for on disk cache settings\&. Many IDE disks just cache writes as the default behaviour, so even flushing database files to disk will not have the desired effect\&.
+.RE
+.PP
+\fBfd_table_size\fR
+.RS 4
+is the maximum number of connections (filedescriptors) that can be open for
+\fBafpd\fR
+client processes in
+\fBcnid_dbd\&.\fR
+Default: 512\&. If this number is exceeded, one of the existing connections is closed and reused\&. The affected
+\fBafpd\fR
+process will transparently reconnect later, which causes slight overhead\&. On the other hand, setting this parameter too high could affect performance in
+\fBcnid_dbd\fR
+since all descriptors have to be checked in a
+\fBselect()\fR
+system call, or worse, you might exceed the per process limit of open file descriptors on your system\&. It is safe to set the value to 1 on volumes where only one
+\fBafpd\fR
+client process is expected to run, e\&.g\&. home directories\&.
+.RE
+.PP
+\fBidle_timeout\fR
+.RS 4
is the number of seconds of inactivity before an idle
-cnid_dbd exits. Default: 600. Set this to 0 to
-disable the timeout.
+\fBcnid_dbd\fR
+exits\&. Default: 600\&. Set this to 0 to disable the timeout\&.
+.RE
+.SH "UPDATING"
+.PP
+In order to update between Netatalk releases using different BerkeleyDB library versions, follow this steps:
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Stop the to be upgraded old version of Netatalk
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Using the old BerkeleyDB utilities run
+\fBdb_recover \-h <path to \&.AppleDB>\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Using the new BerkeleyDB utilities run
+\fBdb_upgrade \-v \-h <path to \&.AppleDB> \-f cnid2\&.db\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Again using the new BerkeleyDB utilities run
+\fBdb_checkpoint \-1 \-h <path to \&.AppleDB>\fR
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+Start the the new version of Netatalk
+.RE
+.PP
+Note that the first version to appear
+\fIafter\fR
+Netatalk 2\&.1 ie Netatalk 2\&.1\&.1, will support BerkeleyDB updates on the fly without manual intervention\&. In other words Netatalk 2\&.1 does contain code to prepare the BerkeleyDB database for upgrades and to upgrade it in case it has been prepared before\&. That means it can\'t upgrade a 2\&.0\&.x version because that one didn\'t prepare the database\&.
.SH "SEE ALSO"
-\fBcnid_metad\fR(8), \fBafpd\fR(8)
-
+.PP
+\fBcnid_metad\fR(8),
+\fBafpd\fR(8),
+\fBdbd\fR(1)
.\" Title: cnid_metad
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
-.\" Date: 9 Jun 2009
-.\" Manual: Netatalk 2.1
-.\" Source: Netatalk 2.1
+.\" Date: 23 Dec 2009
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
.\" Language: English
.\"
-.TH "CNID_METAD" "8" "9 Jun 2009" "Netatalk 2\&.1" "Netatalk 2.1"
+.TH "CNID_METAD" "8" "23 Dec 2009" "Netatalk 2.1beta" "Netatalk 2.1beta"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
Use
\fIhostname\fR
as the network interface for requests as opposed to the default
-\fBlocalhost \fR\&.
+\fBlocalhost\fR\&. The network address may be specified either in dotted\-decimal format for IPv4 or in hexadecimal format for IPv6\&.
.RE
.PP
\fB\-p\fR\fI port\fR
-.\" t
-.TH papd 8 "06 September 2004" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: papd
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 06 September 2004
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
+.\" Language: English
+.\"
+.TH "PAPD" "8" "06 September 2004" "Netatalk 2.1beta" "Netatalk 2.1beta"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
papd \- AppleTalk print server daemon
-.SH SYNOPSIS
-\fBpapd\fR [\-d] [\-f configfile] [\-p printcap]
-.SH DESCRIPTION
-papd is the AppleTalk printer daemon. This daemon
-accepts print jobs from AppleTalk clients (typically Macintosh computers)
-using the Printer Access Protocol (PAP). When used with System V printing
-systems, papd spools jobs directly into an
-\fBlpd\fR(8) spool directory and wakes up lpd
-after accepting a job from the network to have it re\-examine the
-appropriate spool directory. The actual printing and spooling is handled
-entirely by lpd.
-.PP
-papd can also pipe the print job to an external
-program for processing, and this is the preferred method on systems not
-using CUPS to avoid compatibility problems with all the flavours of
-lpd in use.
-.PP
-As of version 2.0, CUPS is also supported. Simply using \fIcupsautoadd\fR as first papd.conf entry will share all
-CUPS printers automagically using the PPD files configured in CUPS. It ist
-still possible to overwrite these defaults by individually define printer
-shares. See \fBpapd.conf\fR(5) for details.
-.PP
-papd is typically started at boot time, out of
-system init scripts. It first reads from its configuration file,
-\fB:ETCDIR:/papd.conf\fR. The file is in the same format as
-\fB/etc/printcap\fR. See \fBprintcap\fR(5) for details. The name of the entry is registered with
-NBP.
-.PP
-The following options are supported:
+.SH "SYNOPSIS"
+.HP \w'\fBpapd\fR\fB\fR\fB\fR\ 'u
+\fBpapd\fR\fB\fR\fB\fR [\-d] [\-f\ configfile] [\-p\ printcap]
+.SH "DESCRIPTION"
+.PP
+\fBpapd\fR
+is the AppleTalk printer daemon\&. This daemon accepts print jobs from AppleTalk clients (typically Macintosh computers) using the Printer Access Protocol (PAP)\&. When used with System V printing systems,
+\fBpapd\fR
+spools jobs directly into an
+\fBlpd\fR(8)
+spool directory and wakes up
+\fBlpd\fR
+after accepting a job from the network to have it re\-examine the appropriate spool directory\&. The actual printing and spooling is handled entirely by
+\fBlpd\fR\&.
+.PP
+\fBpapd\fR
+can also pipe the print job to an external program for processing, and this is the preferred method on systems not using CUPS to avoid compatibility problems with all the flavours of
+\fBlpd\fR
+in use\&.
+.PP
+As of version 2\&.0, CUPS is also supported\&. Simply using
+\fBcupsautoadd\fR
+as first papd\&.conf entry will share all CUPS printers automagically using the PPD files configured in CUPS\&. It ist still possible to overwrite these defaults by individually define printer shares\&. See
+\fBpapd.conf\fR(5)
+for details\&.
+.PP
+\fBpapd\fR
+is typically started at boot time, out of system init scripts\&. It first reads from its configuration file,
+:ETCDIR:/papd\&.conf\&. The file is in the same format as
+/etc/printcap\&. See
+\fBprintcap\fR(5)
+for details\&. The name of the entry is registered with NBP\&.
+.PP
+The following options are supported:
.TS
-c c c l.
+tab(:);
+cB cB cB nB.
T{
Name
-T} T{
+T}:T{
Type
-T} T{
+T}:T{
Default
-T} T{
+T}:T{
Description
T}
.T&
+c l l l
+c l l l
+c l l l
+c l l l
+c l l l
+c l l l
+c l l l
+c l l l
+c l l l
c l l l.
T{
pd
-T} T{
+T}:T{
str
-T} T{
-\&'.ppd'
-T} T{
+T}:T{
+\'\&.ppd\'
+T}:T{
Pathname to PPD file
T}
T{
pr
-T} T{
+T}:T{
str
-T} T{
-\&'lp'
-T} T{
+T}:T{
+\'lp\'
+T}:T{
LPD or CUPS printer name (or pipe to a print
-command)
+ command)
T}
T{
op
-T} T{
+T}:T{
str
-T} T{
-\&'operator'
-T} T{
+T}:T{
+\'operator\'
+T}:T{
Operator name for LPD spooling
T}
T{
au
-T} T{
+T}:T{
bool
-T} T{
+T}:T{
false
-T} T{
+T}:T{
Whether to do authenticated printing or not
T}
T{
ca
-T} T{
+T}:T{
str
-T} T{
+T}:T{
NULL
-T} T{
+T}:T{
Pathname used for CAP\-style authentification
T}
T{
sp
-T} T{
+T}:T{
bool
-T} T{
+T}:T{
false
-T} T{
+T}:T{
PSSP\-style authetication
T}
T{
am
-T} T{
+T}:T{
str
-T} T{
+T}:T{
NULL
-T} T{
+T}:T{
UAMS to use for authentication
T}
T{
pa
-T} T{
+T}:T{
str
-T} T{
+T}:T{
NULL
-T} T{
-Printer's AppleTalk address
+T}:T{
+Printer\'s AppleTalk address
T}
T{
co
-T} T{
+T}:T{
str
-T} T{
+T}:T{
NULL
-T} T{
+T}:T{
CUPS options as supplied to the \fBlp\fR(1) command with "\-o"
T}
T{
fo
-T} T{
+T}:T{
bool
-T} T{
+T}:T{
false
-T} T{
+T}:T{
adjust lineending for foomatic\-rip
T}
.TE
-If no configuration file is given, the hostname of the
-machine is used as the NBP name and all options take their default
-value.
-.SH OPTIONS
-.TP
+.sp 1
+If no configuration file is given, the hostname of the machine is used as the NBP name and all options take their default value\&.
+.SH "OPTIONS"
+.PP
\-d
-Do not fork or disassociate from the terminal. Write some
-debugging information to stderr.
-.TP
+.RS 4
+Do not fork or disassociate from the terminal\&. Write some debugging information to stderr\&.
+.RE
+.PP
\-f \fIconfigfile\fR
-Consult \fIconfigfile\fR instead of
-\fB:ETCDIR:/papd.conf\fR for the configuration
-information.
-.TP
+.RS 4
+Consult
+\fIconfigfile\fR
+instead of
+:ETCDIR:/papd\&.conf
+for the configuration information\&.
+.RE
+.PP
\-p \fIprintcap\fR
-Consult \fIprintcap\fR instead of
-\fB/etc/printcap\fR for LPD configuration
-information.
-.SH NOTES
-PSSP (Print Server Security Protocol) is an authentication
-protocol carried out through postscript printer queries to the print
-server. Using PSSP requires LaserWriter 8.6.1 or greater on the client
-mac. The user will be prompted to enter their username and password before
-they print. It may be necessary to re\-setup the printer on each client the
-first time PSSP is enabled, so that the client can figure out that
-authentication is required to print. You can enable PSSP on a per\-printer
-basis. PSSP is the recommended method of authenticating printers as it is
-more robust than CAP\-style authentication, described below.
-.PP
-CAP\-style authentication gets its name from the method the CAP (Columbia APpletalk)
-package used to authenticate its mac clients' printing. This method
-requires that a user login to a file share before they print.
-afpd records the username in a temporary file named
-after the client's Appletalk address, and it deletes the temporary file
-when the user disconnects. Therefore CAP style authentification will
-\fInot\fR work for clients connected to
-afpd via TCP/IP. papd gets the
-username from the file with the same Appletalk address as the machine
-connecting to it. CAP\-style authentication will work with any mac client.
-If both CAP and PSSP are enabled for a particular printer, CAP will be
-tried first, then papd will fall back to PSSP.
-.PP
-The list of UAMs to use for authentication (specified with the 'am' option)
-applies to all printers. It is not possible to define different
-authentication methods on each printer. You can specify the list of UAMS
-multiple times, but only the last setting will be used. Currently only
-uams_guest.so and uams_clrtxt.so are supported as printer authentication
-methods. The guest method requires a valid username, but not a password.
-The Cleartext UAM requires both a valid username and the correct
-password.
-.RS
+.RS 4
+Consult
+\fIprintcap\fR
+instead of
+/etc/printcap
+for LPD configuration information\&.
+.RE
+.SH "NOTES"
+.PP
+PSSP
+(Print Server Security Protocol) is an authentication protocol
+carried out through postscript printer queries to the print server\&. Using PSSP requires LaserWriter 8\&.6\&.1 or greater on the client mac\&. The user will be prompted to enter their username and password before they print\&. It may be necessary to re\-setup the printer on each client the first time PSSP is enabled, so that the client can figure out that authentication is required to print\&. You can enable PSSP on a per\-printer basis\&. PSSP is the recommended method of authenticating printers as it is more robust than CAP\-style authentication, described below\&.
+.PP
+CAP\-style authentication
+gets its name from the method the CAP (Columbia APpletalk) package used to authenticate its mac clients\' printing\&. This method requires that a user login to a file share before they print\&.
+\fBafpd\fR
+records the username in a temporary file named after the client\'s Appletalk address, and it deletes the temporary file when the user disconnects\&. Therefore CAP style authentification will
+\fInot\fR
+work for clients connected to
+\fBafpd\fR
+via TCP/IP\&.
+\fBpapd\fR
+gets the username from the file with the same Appletalk address as the machine connecting to it\&. CAP\-style authentication will work with any mac client\&. If both CAP and PSSP are enabled for a particular printer, CAP will be tried first, then
+\fBpapd\fR
+will fall back to PSSP\&.
+.PP
+The list of UAMs to use for authentication (specified with the \'am\' option) applies to all printers\&. It is not possible to define different authentication methods on each printer\&. You can specify the list of UAMS multiple times, but only the last setting will be used\&. Currently only uams_guest\&.so and uams_clrtxt\&.so are supported as printer authentication methods\&. The guest method requires a valid username, but not a password\&. The Cleartext UAM requires both a valid username and the correct password\&.
+.if n \{\
+.sp
+.\}
+.RS 4
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+.ps +1
\fBNote\fR
+.ps -1
+.br
+.PP
+As of this writing, Mac OS X makes no use of PSSP authentication any longer\&. CAP\-style authentication normally won\'t be an option, too caused by the use of AFP over TCP these days\&.
+.sp .5v
+.RE
+.PP
+.SH "FILES"
+.PP
+:ETCDIR:/papd\&.conf
+.RS 4
+Default configuration file\&.
+.RE
.PP
-As of this writing, Mac OS X makes no use of PSSP authentication
-any longer. CAP\-style authentication normally won't be an option, too
-caused by the use of AFP over TCP these days.
+/etc/printcap
+.RS 4
+Printer capabilities database\&.
.RE
.PP
-.SH FILES
-.TP
-\fB:ETCDIR:/papd.conf\fR
-Default configuration file.
-.TP
-\fB/etc/printcap\fR
-Printer capabilities database.
-.TP
-\fB\&.ppd\fR
-PostScript Printer Description file. papd answers
-configuration and font queries from printing clients by consulting
-the configured PPD file. Such files are available for download from
-Adobe, Inc. (http://www.adobe.com/support/downloads/main.htm),
-or from the printer's manufacturer. If no PPD file is configured,
-papd will return the default answer, possibly causing the client to
-send excessively large jobs.
-.SH CAVEATS
-papd accepts characters with the high bit set (a
-full 8\-bits) from the clients, but some PostScript printers (including
-Apple Computer's LaserWriter family) only accept 7\-bit characters on their
-serial interface by default. The same applies for some printers when
-they're accessed via TCP/IP methods (remote LPR or socket). You will need
-to configure your printer to accept a full 8 bits or take special
-precautions and convert the printjob's encoding (eg. by using \fIco="protocol=BCP"\fR when using CUPS 1.1.19 or
-above).
-.PP
-When printing clients run MacOS 10.2 or above, take care that PPDs
-do not make use of \fI*cupsFilter:\fR comments
-unless the appropriate filters are installed at the client's side, too
-(remember: Starting with 10.2 Apple chose to integrate CUPS into MacOS X).
-For in\-depth information on how CUPS uses PPDs see chapter 3.4 in http://tinyurl.com/zbxn).
+\&.ppd
+.RS 4
+PostScript Printer Description file\&. papd answers configuration and font queries from printing clients by consulting the configured PPD file\&. Such files are available for download from Adobe, Inc\&. (\m[blue]\fBhttp://www\&.adobe\&.com/support/downloads/main\&.htm\fR\m[]\&\s-2\u[1]\d\s+2), or from the printer\'s manufacturer\&. If no PPD file is configured, papd will return the default answer, possibly causing the client to send excessively large jobs\&.
+.RE
+.SH "CAVEATS"
+.PP
+\fBpapd\fR
+accepts characters with the high bit set (a full 8\-bits) from the clients, but some PostScript printers (including Apple Computer\'s LaserWriter family) only accept 7\-bit characters on their serial interface by default\&. The same applies for some printers when they\'re accessed via TCP/IP methods (remote LPR or socket)\&. You will need to configure your printer to accept a full 8 bits or take special precautions and convert the printjob\'s encoding (eg\&. by using
+\fBco="protocol=BCP"\fR
+when using CUPS 1\&.1\&.19 or above)\&.
+.PP
+When printing clients run MacOS 10\&.2 or above, take care that PPDs do not make use of
+\fB*cupsFilter:\fR
+comments unless the appropriate filters are installed at the client\'s side, too (remember: Starting with 10\&.2 Apple chose to integrate CUPS into MacOS X)\&. For in\-depth information on how CUPS uses PPDs see chapter 3\&.4 in
+\m[blue]\fB http://tinyurl\&.com/zbxn\fR\m[]\&\s-2\u[2]\d\s+2)\&.
.SH "SEE ALSO"
-\fBlpr\fR(1),\fBlprm\fR(1),\fBprintcap\fR(5),\fBlpc\fR(8),\fBlpd\fR(8), \fBlp\fR(1).
-
+.PP
+\fBlpr\fR(1),\fBlprm\fR(1),\fBprintcap\fR(5),\fBlpc\fR(8),\fBlpd\fR(8),
+\fBlp\fR(1)\&.
+.SH "NOTES"
+.IP " 1." 4
+http://www.adobe.com/support/downloads/main.htm
+.RS 4
+\%http://www.adobe.com/support/downloads/main.html#Printer
+.RE
+.IP " 2." 4
+http://tinyurl.com/zbxn
+.RS 4
+\%http://tinyurl.com/zbxn
+.RE
-.TH papstatus 8 "17 Dec 1991" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: papstatus
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 17 Dec 1991
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
+.\" Language: English
+.\"
+.TH "PAPSTATUS" "8" "17 Dec 1991" "Netatalk 2.1beta" "Netatalk 2.1beta"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
papstatus \- get the status of an AppleTalk\-connected printer
-.SH SYNOPSIS
-\fB:SBINDIR:/papstatus\fR [\-d] [ \-p \fBprinter\fR ] [\fBretrytime\fR]
-.SH DESCRIPTION
-\fIpapstatus\fR is used to obtain the
-current status message from an AppleTalk connected printer. It uses the
-Printer Access Protocol (PAP) to obtain the status information.
+.SH "SYNOPSIS"
+.HP \w'\fB:SBINDIR:/papstatus\fR\fB\fR\ 'u
+\fB:SBINDIR:/papstatus\fR\fB\fR [\-d] [\-p\ \fIprinter\fR] [\fIretrytime\fR]
+.SH "DESCRIPTION"
+.PP
+\fBpapstatus\fR
+is used to obtain the current status message from an AppleTalk connected printer\&. It uses the Printer Access Protocol (PAP) to obtain the status information\&.
+.PP
+If no printer is specified on the command line,
+\fBpapstatus\fR
+looks for a file called
+\fB\&.paprc\fR
+in the current directory and reads it to obtain the name of a printer\&. The
+\fB\&.paprc\fR
+file should contain a single line of the form
+\fIobject\fR\fB:\fR\fItype\fR\fB@\fR\fIzone\fR
+where each of
+\fIobject\fR,
+\fB:\fR\fItype\fR\fB,\fR
+and
+\fB@\fR\fIzone\fR
+are optional\&.
+\fItype\fR
+and
+\fIzone\fR
+must be proceeded by `\fB:\fR\' and `\fB@\fR\' respectively\&. Blank lines and lines the begin with a `\fB#\fR\' are ignored\&.
+\fItype\fR
+and
+\fIzone\fR
+default to
+\fBLaserWriter\fR
+and the zone of the local host, respectively\&.
+.SH "OPTIONS"
.PP
-If no printer is specified on the command line, \fIpapstatus\fR
-looks for a file called .paprc in the current directory
-and reads it to obtain the name of a printer. The .paprc
-file should contain a single line of the form \fIobject\fR\fI:\fR\fI\fR\fItype\fR\fI@\fR\fI\fR\fIzone\fR
-where each of \fIobject\fR, \fI:\fR\fItype\fR\fI,\fR and \fI@\fR\fIzone\fR are optional.
-\fItype\fR and \fIzone\fR
-must be proceeded by `\fI:\fR' and `\fI@\fR' respectively. Blank lines and lines the begin
-with a `\fI#\fR' are ignored. \fItype\fR and \fIzone\fR default
-to \fILaserWriter\fR and the zone of the local
-host, respectively.
-.SH OPTIONS
-.TP
\fB\-d\fR
-Turns on a debugging mode that prints some extra information
-to standard error.
-.TP
+.RS 4
+Turns on a debugging mode that prints some extra information to standard error\&.
+.RE
+.PP
\fB\-p\fR \fIprinter\fR
-Get status from \fIprinter\fR (do not
-consult any .paprc files to find a printer name).
-The syntax for \fIprinter\fR is the same as
-discussed above for the .paprc file.
-.TP
+.RS 4
+Get status from
+\fIprinter\fR
+(do not consult any
+\fB\&.paprc\fR
+files to find a printer name)\&. The syntax for
+\fIprinter\fR
+is the same as discussed above for the
+\fB\&.paprc\fR
+file\&.
+.RE
+.PP
+\fIretrytime\fR
+.RS 4
+Normally,
+\fBpapstatus\fR
+only gets the status from the printer once\&. If
\fIretrytime\fR
-Normally, \fIpapstatus\fR only gets
-the status from the printer once. If \fIretrytime\fR
is specified, the status is obtained repeatedly, with a sleep of
-\fIretrytime\fR seconds between inquiring
-the printer.
-.SH FILES
-.TP
-\&.paprc
+\fIretrytime\fR
+seconds between inquiring the printer\&.
+.RE
+.SH "FILES"
+.PP
+\fB\&.paprc\fR
+.RS 4
file that contains printer name
+.RE
.SH "SEE ALSO"
+.PP
\fBnbp\fR(1),
\fBpap\fR(1)
-
-.TH psf 8 "17 Dec 1991" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: psf
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 17 Dec 1991
+.\" Manual: Netatalk 2.1beta
+.\" Source: Netatalk 2.1beta
+.\" Language: English
+.\"
+.TH "PSF" "8" "17 Dec 1991" "Netatalk 2.1beta" "Netatalk 2.1beta"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
psf \- PostScript filter
-.SH SYNOPSIS
-\fBpsf\fR [ \-n \fBname\fR ] [ \-h \fBhost\fR ] [ \-w \fBwidth\fR ] [ \-l \fBlength\fR ] [ \-i \fBindent\fR ] [\-c]
-.SH DESCRIPTION
-psf is an \fIlpd\fR
-filter for PostScript printing. psf interprets the name
-it was called with to determine what filters to invoke. First, if the
-string ``pap'' appears anywhere in the name, psf
-invokes \fIpap\fR to talk to a printer via
-AppleTalk. Next, if the string ``rev'' appears,
-psf invokes \fIpsorder\fR to
-reverse the pages of the job. Finally, if psf was
-called with a filter's name as the leading string, it invokes that
-filter. If there is no filter to run, psf examines the
-magic number of the input, and if the input is not PostScript, converts it
-to PostScript.
-.SH KLUDGE
-In the default configuration, psf supports two
-kludges. The first causes psf to check its name for the
-letter `m'. If this letter is found and accounting is turned on,
-psf calls \fIpap\fR twice,
-once to get an initial page count and to print the job, and another time
-to get a final page count. This is a work\-around for bugs in a variety of
-PAP implementions that cause printers to never properly close the PAP
-output file. A notable example is any printer by Hewlett\-Packard.
+.SH "SYNOPSIS"
+.HP \w'\fBpsf\fR\fB\fR\ 'u
+\fBpsf\fR\fB\fR [\-n\ \fIname\fR] [\-h\ \fIhost\fR] [\-w\ \fIwidth\fR] [\-l\ \fIlength\fR] [\-i\ \fIindent\fR] [\-c]
+.SH "DESCRIPTION"
.PP
-The second kludge causes psf to examine its name
-for the letter `w'. If this letter is found and accounting is turned
-on, psf calls \fIpap\fR with
-the \fB\-w\fR flag. This flag causes \fIpap\fR
-to wait until the printer's status contains the string `idle'.
-Once this string is found, the job is printed as normal. This kludge is a
-work\-around for printers, notably Hewlett\-Packard's LaserJet IV, which
-will report a page count while a previous jobs is still printing.
-.SH EXAMPLE
-The sample \fIprintcap\fR entry below
-invokes psf to print text files, PostScript files,
-\fItroff\fR's C/A/T output, and \fITeX\fR's DVI output, to an AppleTalk connected
-LaserWriter Plus. Since the LaserWriter Plus stacks pages in descending
-order, we reverse the pages and print the burst page last.
+\fBpsf\fR
+is an
+\fBlpd\fR
+filter for PostScript printing\&.
+\fBpsf\fR
+interprets the name it was called with to determine what filters to invoke\&. First, if the string ``pap\'\' appears anywhere in the name,
+\fBpsf\fR
+invokes
+\fBpap\fR
+to talk to a printer via AppleTalk\&. Next, if the string ``rev\'\' appears,
+\fBpsf\fR
+invokes
+\fBpsorder\fR
+to reverse the pages of the job\&. Finally, if
+\fBpsf\fR
+was called with a filter\'s name as the leading string, it invokes that filter\&. If there is no filter to run,
+\fBpsf\fR
+examines the magic number of the input, and if the input is not PostScript, converts it to PostScript\&.
+.SH "KLUDGE"
.PP
+In the default configuration,
+\fBpsf\fR
+supports two kludges\&. The first causes
+\fBpsf\fR
+to check its name for the letter `m\'\&. If this letter is found and accounting is turned on,
+\fBpsf\fR
+calls
+\fBpap\fR
+twice, once to get an initial page count and to print the job, and another time to get a final page count\&. This is a work\-around for bugs in a variety of PAP implementions that cause printers to never properly close the PAP output file\&. A notable example is any printer by Hewlett\-Packard\&.
+.PP
+The second kludge causes
+\fBpsf\fR
+to examine its name for the letter `w\'\&. If this letter is found and accounting is turned on,
+\fBpsf\fR
+calls
+\fBpap\fR
+with the
+\fB\-w\fR
+flag\&. This flag causes
+\fBpap\fR
+to wait until the printer\'s status contains the string `idle\'\&. Once this string is found, the job is printed as normal\&. This kludge is a work\-around for printers, notably Hewlett\-Packard\'s LaserJet IV, which will report a page count while a previous jobs is still printing\&.
+.SH "EXAMPLE"
+.PP
+The sample
+\fBprintcap\fR
+entry below invokes
+\fBpsf\fR
+to print text files, PostScript files,
+\fBtroff\fR\'s C/A/T output, and
+\fBTeX\fR\'s DVI output, to an AppleTalk connected LaserWriter Plus\&. Since the LaserWriter Plus stacks pages in descending order, we reverse the pages and print the burst page last\&.
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
-
-laser|lp|LaserWriter Plus on AppleTalk:\\
- :sd=/usr/spool/lpd/laser:\\
- :lp=/usr/spool/lpd/laser/null:\\
- :lf=/var/adm/lpd\-errs:pw#80:hl:\\
- :of=:LIBEXECDIR:/ofpap:\\
- :if=:LIBEXECDIR:/ifpaprev:\\
- :tf=:LIBEXECDIR:/tfpaprev:\\
+laser|lp|LaserWriter Plus on AppleTalk:\e
+ :sd=/usr/spool/lpd/laser:\e
+ :lp=/usr/spool/lpd/laser/null:\e
+ :lf=/var/adm/lpd\-errs:pw#80:hl:\e
+ :of=:LIBEXECDIR:/ofpap:\e
+ :if=:LIBEXECDIR:/ifpaprev:\e
+ :tf=:LIBEXECDIR:/tfpaprev:\e
:df=:LIBEXECDIR:/dfpaprev:
.fi
+.if n \{\
+.RE
+.\}
.PP
-Note that if the host in question spools to more than one AppleTalk
-printer, \fB/dev/null\fR should not be used for the
-\fIlp\fR capability. Instead, a null device
-should be created with \fImknod\fR for each
-printer, as has been done above.
+Note that if the host in question spools to more than one AppleTalk printer,
+/dev/null
+should not be used for the
+\fBlp\fR
+capability\&. Instead, a null device should be created with
+\fBmknod\fR
+for each printer, as has been done above\&.
.PP
Finally, there is a file in the spool directory,
-\fB/var/spool/lpd/laser\fR, called .paprc,
-which \fIpap\fR reads for the AppleTalk name of
-the printer.
+/var/spool/lpd/laser, called
+\fB\&.paprc\fR, which
+\fBpap\fR
+reads for the AppleTalk name of the printer\&.
.SH "SEE ALSO"
+.PP
\fBpsorder\fR(1),
\fBprintcap\fR(5),
\fBlpd\fR(1),
\fBmknod\fR(1),
-\fBpap\fR(1).
-
+\fBpap\fR(1)\&.
-.TH timelord 8 "27 Jun 2001" 2.0.0 Netatalk
-.SH NAME
+'\" t
+.\" Title: timelord
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 27 Jun 2001
+.\" Manual: The Netatalk Project
+.\" Source: Netatalk 2.1beta
+.\" Language: English
+.\"
+.TH "TIMELORD" "8" "27 Jun 2001" "Netatalk 2.1beta" "The Netatalk Project"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
timelord \- Macintosh time server daemon
-.SH SYNOPSIS
-.SH SYNTAX
-timelord [\-d] [\-n \fIfilename\fR]
-.SH DESCRIPTION
-\fItimelord\fR is a simple time server for
-Macintosh computers that use the \fItardis\fR
-client.
-.SH OPTIONS
-.TP
+.SH "SYNOPSIS"
+.SH "SYNTAX"
+.PP
+timelord [\-d] [\-n
+\fIfilename\fR]
+.SH "DESCRIPTION"
+.PP
+\fBtimelord\fR
+is a simple time server for Macintosh computers that use the
+\fBtardis\fR
+client\&.
+.SH "OPTIONS"
+.PP
\fB\-d\fR
-Debug mode, i.e. don't disassociate from controlling
-TTY.
-.TP
+.RS 4
+Debug mode, i\&.e\&. don\'t disassociate from controlling TTY\&.
+.RE
+.PP
\fB\-n\fR \fInbpname\fR
-Register this server as \fInbpname\fR. This defaults to the hostname.
-
+.RS 4
+Register this server as
+\fInbpname\fR\&. This defaults to the hostname\&.
+.RE
projects / netatalk.git / commitdiff