-.TH ACHFILE 1 "26 Feb 1998"
+.TH achfile 1 26\ Feb\ 1998 "Netatalk 2.0-alpha1"
.SH NAME
-achfile \- change type and/or creator of Apple Macintosh files (netatalk format)
+achfile \- change type and/or creator of Apple Macintosh files (netatalk format)
.SH SYNOPSIS
-.B achfile
-[
-.B -t
-.I type
-]
-[
-.B -c
-.I creator
-]
-.I file ...
-
+\fBachfile\fR [ \-t \fBtype\fR ] [ \-c \fBcreator\fR ] \fBfile\fR \&...
.SH DESCRIPTION
-.B achfile
-changes the Macintosh type and/or creator of the
-.I file
-arguments which have a
+achfile changes the Macintosh type and/or creator
+of the \fIfile\fR arguments which have a
corresponding .AppleDouble file.
-
.SH OPTIONS
-.HP
-.B -t
-.I type
-.br
-change the type.
-
-.HP
-.B -c
-.I creator
-.br
-change the creator.
-
+\fB\-t\fR \fItype\fR change the type.
+.PP
+\fB\-c\fR \fIcreator\fR change the
+creator.
.SH DIAGNOSTICS
returns exit status 0 if all files changed successfully
-.SH SEE ALSO
-.BR afile (1),
-.BR afpd (1)
+.SH SEE\ ALSO
+\fBafile\fR(1),
+\fBafpd\fR(8)
+
-.TH ACLEANDIR 1 "26 Feb 1998"
+.TH acleandir 1 26\ Feb\ 1998 "Netatalk 2.0-alpha1"
.SH NAME
-acleandir \- clean up a directory containing netatalk Apple Macintosh files
+acleandir \- clean up a directory containing netatalk Apple Macintosh files
.SH SYNOPSIS
-.B acleandir
-[
-.B -rnvi
-]
-.I dirname
-
+\fBacleandir\fR [\-rnvi] \fBdirname\fR
+.sp 1
.SH DESCRIPTION
-.B acleandir
-cleans up the directory
-.I dirname.
-By default
-it simply removes
-"orphan" AppleDouble files, i.e. those
-which do not have a corresponding data file.
+acleandir cleans up the directory \fIdirname.\fR By default it simply removes
+"orphan" AppleDouble files, i.e. those which do not have a
+corresponding data file.
.SH OPTIONS
-.TP
-.B -d
-Also remove the .AppleDouble directory if it contains no AppleDouble
-files after "orphan" removal. This will result in the finder location of
-.I dirname
+.TP
+\fB\-d\fR
+Also remove the .AppleDouble directory if it contains no
+AppleDouble files after "orphan" removal. This will result
+in the finder location of \fIdirname\fR
within its parent being lost.
-.TP
-.B -r
-.PD 0
-.TP
-.B -R
+.TP
+\fB\-r\fR, \fB\-R\fR
Recursive. Clean up directories recursively.
-
-.TP
-.B -n
-Display the filenames of "orphans" but don't remove any. Display size
-if "orphan" appears to contain a resource fork.
-
-.TP
-.B -i
-Interactive. Prompt for confirmation before a removal.
-A y in answer confirms that the removal should proceed.
-
-.TP
-.B -v
-Verbose. Display the names of all "orphans" and .AppleDouble directories removed. Reports the size if the "orphan" appears to contain a resource fork.
-
-.TP
-.B -a
-Aggressive. Remove all AppleDouble files, not just "orphans". Also remove
-the .AppleDesktop directory if present.
-Impies
-.B -d
-option.
-Use with caution as the Macintosh type/creator and finder location
-of all files will be lost and the content of some documents, such
-as Symantec Projects, will be destroyed.
-
+.TP
+\fB\-n\fR
+Display the filenames of "orphans" but don't
+remove any. Display size if "orphan" appears to contain a
+resource fork.
+.TP
+\fB\-i\fR
+Interactive. Prompt for confirmation before a removal. A y in
+answer confirms that the removal should proceed.
+.TP
+\fB\-v\fR
+Verbose. Display the names of all "orphans" and
+\&.AppleDouble directories removed. Reports the size if the
+"orphan" appears to contain a resource fork.
+.TP
+\fB\-a\fR
+Aggressive. Remove all AppleDouble files, not just
+"orphans". Also remove the .AppleDesktop directory if
+present. Impies \fB\-d\fR option. Use with caution as the
+Macintosh type/creator and finder location of all files will be lost
+and the content of some documents, such as Symantec Projects, will
+be destroyed.
.SH DIAGNOSTICS
-returns exit status 0 unless bad options are provided or a directory is not given
-on the command line.
+returns exit status 0 unless bad options are provided or a directory
+is not given on the command line.
+.SH SEE\ ALSO
+\fBafile\fR(1),
+\fBafpd\fR(8)
-
-.SH SEE ALSO
-.BR afile (1),
-.BR afpd (1)
-.TH AECHO 1 "17 Dec 1991" "netatalk 1.2"
+.TH aecho 1 17\ Dec\ 1991 "Netatalk 2.0-alpha1"
.SH NAME
aecho \- send AppleTalk Echo Protocol packets to network hosts
.SH SYNOPSIS
-.B aecho
-[
-.B \-c\fI count
-]
-(
-.I address
-|
-.I nbpname
-)
+aecho [ \fB\-c\fR\fI count\fR
+] ( address | nbpname )
.SH DESCRIPTION
-.B aecho
-repeatedly sends an Apple Echo Protocol (AEP) packet to the host
-specified by the given AppleTalk
-.I address
-or
-.I nbpname
-and reports whether a reply was received. Requests are sent at the
-rate of one per second.
-.LP
-.I address
-is parsed by
-.BR atalk_aton (3).
-.I nbpname
-is parsed by
-.BR nbp_name (3).
-The nbp type defaults to
-.RB ` Workstation '.
-.LP
-When
-.B 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.
+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.
+.PP
+address is parsed by
+\fBatalk_aton\fR(3).
+nbpname is parsed by \fBnbp_name\fR(3).
+The nbp type defaults to `\fIWorkstation\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:
-.sp
-.RS
+Check to see if a particular host is up and responding to AEP
+packets:
+.PP
.nf
- example% aecho 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----
- 6 packets sent, 6 packets received, 0% packet loss
- round-trip (ms) min/avg/max = 9/9/10
-.fi
-.RE
+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\-\-\-\-
+6 packets sent, 6 packets received, 0% packet loss
+round\-trip (ms) min/avg/max = 9/9/10
+\fR.fi
.SH OPTIONS
-.TP
-.B \-c\fI count
-Stop after
-.I count
-packets.
-.SH SEE ALSO
-.BR ping (1),
-.BR atalk_aton (3),
-.BR nbp_name (3),
-.\" .BR aep (4),
-.BR atalkd (8).
+.TP
+\fB\-c\fR\fI count\fR
+Stop after \fIcount\fR packets.
+.SH SEE\ ALSO
+\fBping\fR(1),
+\fBatalk_aton\fR(3),
+\fBnbp_name\fR(3),
+\fBaep\fR(4),
+\fBatalkd\fR(8).
+
-.TH AFILE 1 "26 Feb 1998"
+.TH afile 1 26\ Feb\ 1998 "Netatalk 2.0-alpha1"
.SH NAME
-afile \- display type and creator of Apple Macintosh files (netatalk format)
+afile \- display type and creator of Apple Macintosh files (netatalk format)
.SH SYNOPSIS
-.B afile
-[
-.B -a
-]
-.I file ...
-
+\fBafile\fR [\-a] \fBfile\fR \&...
+.sp 1
.SH DESCRIPTION
-.B afile
-displays the name and Macintosh type and creator of the
-.I file
-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.
-
-.LP
-.B afile
-does not look at any of the extension mapping files such
-as AppleVolumes.system.
-
+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
-.B -a
-Include directories and data files of unknown type (i.e. without
-corresponding AppleDouble) in output.
-
+.TP
+\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.
-.br
+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
+3 file is directory
+.PP
+4 file is AppleDouble without data fork
+.PP
+5 file is AppleDouble with unreadable data fork
+.PP
+6 file is data fork without AppleDouble
+.PP
+7 file is data fork with unreadable AppleDouble
+.PP
+8 file is data fork with short AppleDouble
+.PP
+9 bad magic in AppleDouble
+.SH SEE\ ALSO
+\fBachfile\fR(1),
+\fBafpd\fR(1)
-1 file doesn't exist
-.br
-2 file is unreadable
-.br
-3 file is directory
-.br
-4 file is AppleDouble without data fork
-.br
-5 file is AppleDouble with unreadable data fork
-.br
-6 file is data fork without AppleDouble
-.br
-7 file is data fork with unreadable AppleDouble
-.br
-8 file is data fork with short AppleDouble
-.br
-9 bad magic in AppleDouble
-
-.SH SEE ALSO
-.BR achfile (1),
-.BR afpd (1)
-.TH AFPPASSWD 1 "03 Aug 2000" "netatalk 1.5"
+.TH afppasswd 1 03\ Aug\ 2000 "Netatalk 2.0-alpha1"
.SH NAME
afppasswd \- netatalk password maintenance utility
.SH SYNOPSIS
-.B afppasswd
-[
-.B \-acfn
-]
-[
-.B \-p\fI passwd file
-]
-[
-.B \-u\fI minimum uid
-]
+\fBafppasswd\fR [\-acfn] [ \-p \fBpasswd\fR \fBfile\fR ] [ \-u \fBminimum\fR \fBuid\fR ]
.SH DESCRIPTION
-.B afppasswd
-allows the maintenance of afppasswd files created by netatalk for
-use by some User Authentication Modules (UAMs)
-.LP
-.B afppasswd
-can either be called by root with parameters, or can be called by
-local system users with no parameters to change their passwords.
+afppasswd allows the maintenance of afppasswd
+files created by netatalk for use by some User Authentication Modules
+(UAMs)
+.PP
+afppasswd can either be called by root with
+parameters, or can be called by local system users with no parameters to
+change their passwords.
.SH EXAMPLE
Local user changing their own password:
-.sp
-.RS
+.PP
.nf
- example% afppasswd
- Enter NEW AFP password: (hidden)
- Enter NEW AFP password again: (hidden)
- afppasswd: updated password.
+example% \fBafppasswd\fR
+Enter NEW AFP password: \fB(hidden)\fR
+Enter NEW AFP password again: \fB(hidden)\fR
+afppasswd: updated password.
.fi
-.RE
.SH OPTIONS
-.TP
-.B \-a
-Add a new user to the
-.B afppasswd
-file.
-.TP
-.B \-c
-Create and/or initialize
-.B afppasswd
-file or specific user.
-.TP
-.B \-f
+.TP
+\fB\-a\fR
+Add a new user to the afppasswd file.
+.TP
+\fB\-c\fR
+Create and/or initialize afppasswd file or
+specific user.
+.TP
+\fB\-f\fR
Force the current action.
-.TP
-.B \-p\fI path
-Path to
-.B afppasswd
-file.
-.TP
-.B \-n
-If cracklib support is built into
-.B netatalk
+.TP
+\fB\-p\fR\fI path\fR
+Path to afppasswd file.
+.TP
+\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
-.B \-u\fI minimum uid
-This is the minimum
-.I user id
-(uid) that
-.B afppasswd
-will use when creating users.
-.SH SEE ALSO
-.BR afpd (8),
-.BR atalkd (8).
+.TP
+\fB\-u\fR\fI minimum uid\fR
+This is the minimum \fIuser id\fR
+(uid) that afppasswd will use when creating
+users.
+.SH SEE\ ALSO
+\fBafpd\fR(8),
+\fBatalkd\fR(8).
+
-.TH APPLE_CP 1 "15 Oct 2001" "Netatalk 1.5"
+.TH apple_cp 1 15\ Oct\ 2001 "Netatalk 2.0-alpha1"
.SH NAME
apple_cp \- Do an apple copy, copying the resource fork as well
.SH SYNOPSIS
-.BR :BINDIR:/apple_cp
-\fISOURCE DEST\fR
-.br
-.BR :BINDIR:/apple_cp
-\fISOURCE\fR... \fIDIRECTORY\fR
-
+\fI:BINDIR:/apple_cp\fR \fISOURCE
+DEST\fR \fI:BINDIR:/apple_cp\fR \fISOURCE\fR... \fIDIRECTORY\fR
.SH DESCRIPTION
-.BR apple_cp
-is a perl script to copy SOURCE to DEST or multiple SOURCE(s) to
-DIRECTORY. It also copies the 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.
-
+\fIapple_cp\fR is a perl script to copy
+SOURCE to DEST or multiple SOURCE(s) to DIRECTORY. It also copies the
+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/
+.PP
+\fI:BINDIR:/apple_cp\fR test.text
+/target/directory/test2.text
+.PP
+\fI: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>.
+.SH SEE\ ALSO
+\fBapple_mv\fR(1),
+\fBapple_rm\fR(1).
-.BR :BINDIR:/apple_cp
-test.text /target/directory/
-
-.BR :BINDIR:/apple_cp
-test.text /target/directory/test2.text
-
-.BR :BINDIR:/apple_cp
-test.text testing.text /target/directory/
-
-.SH REPORTING BUGS
-Report bugs to the Netatalk-devel list <netatalk-devel@lists.sourceforge.net>.
-
-.SH SEE ALSO
-.BR apple_mv (1),
-.BR apple_rm (1).
-.TH APPLE_MV 1 "16 Oct 2001" "Netatalk 1.5"
+.TH apple_mv 1 16\ Oct\ 2001 "Netatalk 2.0-alpha1"
.SH NAME
apple_mv \- Do an apple move, moving the resource fork as well
.SH SYNOPSIS
-.BR :BINDIR:/apple_mv
-\fISOURCE DEST\fR
-.br
-.BR :BINDIR:/apple_mv
-\fISOURCE\fR... \fIDIRECTORY\fR
-
+\fI:BINDIR:/apple_mv\fR \fISOURCE
+DEST\fR \fI:BINDIR:/apple_mv\fR \fISOURCE\fR... \fIDIRECTORY\fR
.SH DESCRIPTION
-.BR apple_mv
-is a perl script to move SOURCE to DEST or multiple SOURCE(s) to
-DIRECTORY. It also moves the 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.
-
+\fIapple_mv\fR is a perl script to move
+SOURCE to DEST or multiple SOURCE(s) to DIRECTORY. It also moves the
+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/
+.PP
+\fI:BINDIR:/apple_mv\fR test.text
+/target/directory/test2.text
+.PP
+\fI: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>.
+.SH SEE\ ALSO
+\fBapple_cp\fR(1),
+\fBapple_rm\fR(1).
-.BR :BINDIR:/apple_mv
-test.text /target/directory/
-
-.BR :BINDIR:/apple_mv
-test.text /target/directory/test2.text
-
-.BR :BINDIR:/apple_mv
-test.text testing.text /target/directory/
-
-.SH REPORTING BUGS
-Report bugs to the Netatalk-devel list <netatalk-devel@lists.sourceforge.net>.
-
-.SH SEE ALSO
-.BR apple_cp (1),
-.BR apple_rm (1).
-.TH APPLE_RM 1 "16 Oct 2001" "Netatalk 1.5"
+.TH apple_rm 1 16\ Oct\ 2001Netatalk\ 1.5
.SH NAME
apple_rm \- Do an apple remove, remove the resource fork as well
-
.SH SYNOPSIS
-.BR :BINDIR:/apple_rm
+\fI:BINDIR:/apple_rm\fR
\fIFILE\fR...
-
.SH DESCRIPTION
-.BR apple_rm
+\fIapple_rm\fR
is a perl script that removes FILE(s) as well as the .AppleDouble
resource fork file(s) that corresponds to FILE(s).
-.BR apple_rm
+\fIapple_rm\fR
does not delete directories.
-
.SH EXAMPLES
-
-.BR :BINDIR:/apple_rm
-test.text
-
-.BR :BINDIR:/apple_rm
+\fI:BINDIR:/apple_rm\fR
+test.text
+.PP
+\fI:BINDIR:/apple_rm\fR
test.text testing.text
-
-.SH REPORTING BUGS
-Report bugs to the Netatalk-devel list <netatalk-devel@lists.sourceforge.net>.
-
-.SH SEE ALSO
-.BR apple_cp (1),
-.BR apple_mv (1).
+.SH REPORTING\ BUGS
+Report bugs to the Netatalk\-devel list <netatalk\-devel@lists.sourceforge.net>.
+.SH SEE\ ALSO
+\fBapple_cp\fR(1),
+\fBapple_mv\fR(1).
-.TH GETZONES 1 "17 Dec 1991" "netatalk 1.2"
+.TH getzones 1 17\ Dec\ 1991 "Netatalk 2.0-alpha1"
.SH NAME
getzones \- list AppleTalk zone names
.SH SYNOPSIS
-.B getzones
-[
-.B -m
-|
-.B -l
-] [
-.I address
-]
+\fBgetzones\fR [\-m | \-l] [\fBaddress\fR]
.SH DESCRIPTION
-.B Getzones
-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
-.BR atalkd (8).
+\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
-.B -m
-List the name of the local zone only; this is accomplished by sending a
-ZIP GetMyZone request.
-.TP
-.B -l
-List the local zones; this is accomplished by sending a GetLocalZones
-request.
-.TP
-.I address
-Contact the AppleTalk router at
-.I address.
-.I address
-is parsed by
-.BR atalk_aton (3).
-.SH SEE ALSO
-.BR atalk_aton (3),
-.\" .BR zip (4),
-.BR atalkd (8).
+.TP
+\fB\-m\fR
+List the name of the local zone only; this is accomplished by
+sending a ZIP GetMyZone request.
+.TP
+\fB\-l\fR
+List the local zones; this is accomplished by sending a
+GetLocalZones request.
+.TP
+\fIaddress\fR
+Contact the AppleTalk router at \fIaddress.\fR
+\fIaddress\fR is parsed by
+\fBatalk_aton\fR(3).
+.SH SEE\ ALSO
+\fBatalk_aton\fR(3),
+\fBzip\fR(4),
+\fBatalkd\fR(8).
+
-.TH MEGATRON 1 "8 Jan 1992" "netatalk 1.2"
+.TH megatron 1 8\ Jan\ 1992 "Netatalk 2.0-alpha1"
.SH NAME
megatron, unhex, unbin, unsingle, hqx2bin, single2bin, macbinary \- Macintosh file format transformer
.SH SYNOPSIS
-.B megatron
-[
-.I sourcefile...
-]
-.LP
-.B unbin
-[
-.I sourcefile...
-]
-.LP
-.B unhex
-[
-.I sourcefile...
-]
-.LP
-.B unsingle
-[
-.I sourcefile...
-]
-.LP
-.B hqx2bin
-[
-.I sourcefile...
-]
-.LP
-.B single2bin
-[
-.I sourcefile...
-]
-.LP
-.B macbinary
-[
-.I sourcefile...
-]
+\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
-.B megatron
-is used to transform files from BinHex, MacBinary, AppleSingle, or
-.B netatalk
-style AppleDouble formats into MacBinary or
-.B netatalk
-style AppleDouble formats. The
-.B netatalk
-style AppleDouble format is the file format used by
-.B afpd,
-the
-.B netatalk
-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.
-.B megatron
-uses its name to determine what type of tranformation is being asked of
-it.
-.LP
-If
-.B megatron
-is called as
-.B unhex, unbin,
-or
-.B 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.
-.LP
-If
-.B megatron
-is called as
-.B hqx2bin, single2bin,
-or
-.B 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
-.B afpd
-server to some other machine when you can't copy them from the server
-using a Macintosh for some reason.
-.LP
-If
-.B megatron
-is called with any other name, it uses the default translation, namely
-.B unhex.
-.LP
-If no source file is given, or if
-.I sourcefile
-is
-.RB ` - ',
-and if the conversion is from a BinHex or MacBinary file,
-.B megatron
+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.
+.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.
+.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.
+.PP
+If megatron is called with any other name, it
+uses the default translation, namely unhex.
+.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.
-.LP
+.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
-.BR afpd (8)
+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
+\fBafpd\fR(8)
+
-.TH NBP 1 "17 Dec 1991" "netatalk 1.2"
+.TH nbp 1 17\ Dec\ 1991 "Netatalk 2.0-alpha1"
.SH NAME
nbplkup, nbprgstr, nbpunrgstr \- access NBP database
.SH SYNOPSIS
-.B nbplkup
-[
-.B -r
-.I nresp
-]
-[
-.I nbpname
-]
-.sp
-.B nbprgstr
-[
-.B -p
-.I port
-]
-.I nbpname
-.sp
-.B nbpunrgstr
-.I nbpname
+\fBnbplkup\fR [ \-r \fBnresp\fR ] [\fBnbpname\fR] \fBnbprgstr\fR [ \-p \fBport\fR ] \fBnbpnamenbpunrgstrnbpname\fR
.SH DESCRIPTION
-.B nbprgstr
-registers
-.I nbpname
-with
-.BR atalkd (8),
-at the given
-.IR port .
-.B nbpunrgstr
-informs
-.B atalkd
-that
-.I nbpname
+\fInbprgstr\fR registers \fInbpname\fR with \fBatalkd\fR(8),
+at the given \fIport\fR. \fInbpunrgstr\fR
+informs \fIatalkd\fR that \fInbpname\fR
is no longer to be advertised.
-.LP
-.B nbplkup
-displays up to
-.I nresp
-(default 1000) entities registered on the AppleTalk internet.
-.I nbpname
-is parsed by
-.BR nbp_name (3).
-An
-.RB ` = '
-for the
-.I object
-or
-.I type
-matches anything, and an
-.RB ` * '
-for
-.I zone
-means the local zone. The default values are taken from the
-.B NBPLKUP
-environment variable, parsed as an
-.IR nbpname .
+.PP
+nbplkup displays up to \fInresp\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.
.SH EXAMPLE
-Find all devices of type
-.B LaserWriter
+Find all devices of type \fILaserWriter\fR
in the local zone.
-.sp
-.RS
+.PP
.nf
-example% nbplkup :LaserWriter
+example% \fBnbplkup :LaserWriter\fR
Petoskey:LaserWriter 7942.129:218
Gloucester:LaserWriter 8200.188:186
Rahway:LaserWriter 7942.2:138
Iron Mountain :LaserWriter 7942.128:250
example%
.fi
-.RE
-.SH SEE ALSO
-.BR nbp_name (3),
-.\" .BR nbp (4),
-.\" .BR zip (4),
-.BR atalkd (8).
+.SH SEE\ ALSO
+\fBnbp_name\fR(3),
+\fBnbp\fR(4),
+\fBzip\fR(4),
+\fBatalkd\fR(8).
+
-.TH netatalk\-config 1 "09 June 2001" "netatalk 1.5pre6" "The Netatalk Project"
+.TH netatalk\-config 1 09\ June\ 2001 "Netatalk 2.0-alpha1"The\ Netatalk\ Project
.SH NAME
-netatalk-config - script to get information about the installed version of netatalk
+netatalk\-config \- script to get information about the installed version of netatalk
.SH SYNOPSIS
-.B netatalk-config
-[\-\-prefix\fI[=DIR]\fP] [\-\-exec_prefix\fI[=DIR]\fP] [\-\-help] [\-\-version]
-[\-\-libs] [\-\-libs\-dirs] [\-\-libs\-names] [\-\-cflags] [\-\-macros]
+\fBnetatalk\-config\fR [ \-\-prefix [\fB=DIR\fR]] [ \-\-exec_prefix [\fB=DIR\fR]] [\-\-help] [\-\-version] [\-\-libs] [\-\-libs\-dirs] [\-\-libs\-names] [\-\-cflags] [\-\-macros]
.SH DESCRIPTION
-.PP
-\fInetatalk-config\fP is a tool that is used to configure to determine
-the compiler and linker flags that should be used to compile
-and link programs that use the \fInetatalk\fP run-time libraries.
-.
+netatalk\-config is a tool that is used to
+configure 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
-.l
-\fInetatalk-config\fP accepts the following options:
-.TP 8
-.B \-\-help
+netatalk\-config accepts the following options:
+.TP
+\fB\-\-help\fR
Print a short help for this command and exit.
-.TP 8
-.B \-\-version
-Print the currently installed version of \fInetatalk\fP on the standard output.
-.TP 8
-.B \-\-libs
-Print the linker flags that are necessary to link against the \fInetatalk\fP
-run-time libraries.
-.TP 8
-.B \-\-libs-dirs
+.TP
+\fB\-\-version\fR
+Print the currently installed version of \fInetatalk\fR
+on the standard output.
+.TP
+\fB\-\-libs\fR
+Print the linker flags that are necessary to link against the
+\fInetatalk\fR run\-time libraries.
+.TP
+\fB\-\-libs\-dirs\fR
Print only the \-l/\-R part of \-\-libs.
-.TP 8
-.B \-\-libs-names
+.TP
+\fB\-\-libs\-names\fR
Print only the \-l part of \-\-libs.
-.TP 8
-.B \-\-cflags
-Print the compiler flags that are necessary to compile a program linked
-against the \fInetatalk\fP run-time libraries.
-.TP 8
-.B \-\-macros
-Print the \fInetatalk\fP m4 directory.
-.TP 8
-.B \-\-prefix=PREFIX
-If specified, use PREFIX instead of the installation prefix that \fInetatalk\fP
-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 8
-.B \-\-exec\_prefix=PREFIX
-If specified, use PREFIX instead of the installation exec prefix that
-\fInetatalk\fP was built with when computing the output for the \-\-cflags
-and \-\-libs options. This option must be specified before any
-\-\-libs or \-\-cflags options.
+.TP
+\fB\-\-cflags\fR
+Print the compiler flags that are necessary to compile a
+program linked against the \fInetatalk\fR
+run\-time libraries.
+.TP
+\fB\-\-macros\fR
+Print the \fInetatalk\fR m4
+directory.
+.TP
+\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
-Copyright \(co 1998 Owen Taylor
-
-Permission to use, copy, modify, and distribute this software and its
-documentation for any purpose and without fee is hereby granted,
+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.
+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 \fInetatalk-config\fP by Sebastian Rittau in 2001.
-.TH PAP 1 "6 May 2002" "netatalk 1.5"
+.TH pap 1 6\ May\ 2002 "Netatalk 2.0-alpha1"
.SH NAME
-pap, papstatus \- client interface to remote printers using Printer Access Protocol
+pap, papstatus \- client interface to remote printers using Printer Access Protocol
.SH SYNOPSIS
-.B pap
-[
-.B -A
-.I address
-] [
-.B -c
-] [
-.B -d
-] [
-.B -e
-] [
-.B -E
-] [
-.B -p
-.I nbpname
-] [
-.B -s
-.I statusfile
-] [
-.B -w
-] [
-.B -W
-] [
-.I FILES
-]
-.sp
-.B papstatus
-[
-.B -p
-.I nbpname
-]
+\fBpap\fR [ \-A \fBaddress\fR ] [\-c] [\-d] [\-e] [\-E] [ \-p \fBnbpname\fR ] [ \-s \fBstatusfile\fR ] [\-w] [\-W] [\fBFILES\fR] \fBpapstatus\fR [ \-p \fBnbpname\fR ]
.SH DESCRIPTION
-.B pap
-is used to connect and send files to an AppleTalk connected printer using
-the Apple Printer Access Protocol (PAP).
-When
-.B pap
-starts execution, it
-tries to open a session with the printer using PAP, and
-then downloads the
-.I files
+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.
-.LP
-If no
-.I files
-are given on the command line,
-.B pap
-begins reading from standard input.
-.LP
-If no printer is specified on the command line,
-.B pap
-looks for a file called
-.B .paprc
-in the current working directory and reads it to obtain the
-.I nbpname
-of a
-printer.
-Blank lines and lines that begin with a
-.RB ` # '
-are ignored.
-.I type
-and
-.I zone
-default to
-.B LaserWriter
-and the zone of the local host, respectively.
-.LP
-Note that
-.B pap
-is designed to be useful as a communication filter for sending
-.BR lpd (8)
-spooled print jobs to AppleTalk connected printers. See
-.BR psf (8)
+.PP
+If no \fIfiles\fR are given on the command
+line, pap begins reading from standard input.
+.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.
+.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
+\fBpsf\fR(8)
for hints on how to use it this way.
.SH OPTIONS
-.HP
-.B -A
-.I address
-.br
-Connect to the printer with Appletalk address
-.I address
-and do not consult the
-.B .paprc
-file to find a printer name. See
-.BR atalk_aton (3)
-for the syntax of
-.IR address .
-.TP
-.B -c
-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
-.B pap
-to lie about how long it has been waiting.
-.TP
-.B -d
+.TP
+\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
+\fBatalk_aton\fR(3)
+for the syntax of \fIaddress\fR.
+.TP
+\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
+\fB\-d\fR
Enable debug output.
-.TP
-.B -e
+.TP
+\fB\-e\fR
Send any message from the printer to stderr instead of stdout.
-.BR psf (8)
-invokes
-.B pap
-with this option.
-.TP
-.B -E
-Don't wait for EOF from the printer. This option is useful
-for printers which don't implement PAP correctly. In a correct
+\fBpsf\fR(8)
+invokes pap with this option.
+.TP
+\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
+return EOF before closing the connection. Some clients don't
wait, and hence some printers have related bugs in their
implementation.
-.HP
-.B -p
-.I nbpname
-.br
-Connect to the printer named
-.I nbpname
-and do not consult the
-.B .paprc
-file to find a printer name. See
-.BR nbp_name (3)
-for the syntax of
-.IR nbpname .
-.HP
-.B -s
-.I statusfile
-.br
-Update the file called
-.I statusfile
+.TP
+\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
+\fB\-s\fR \fIstatusfile\fR
+Update the file called \fIstatusfile\fR
to contain the most recent status message from the printer.
-.B pap
-gets the status from the printer when it is waiting for the printer to
-process input. The
-.I statusfile
-will contain a single line terminated with a newline. This is useful
-when
-.B pap
-is invoked by
-.BR psf (8)
-within
-.BR lpd 's
-spool directory.
-.TP
-.B -w
-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
-.B -W
-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.
+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
+\fBpsf\fR(8)
+within \fIlpd\fR's spool directory.
+.TP
+\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
+\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 20
-.B .paprc
-file read to obtain printer name if not specified on command line
-.SH SEE ALSO
-.BR nbp_name (3),
-.BR atalk_aton (3),
-.BR lpd (8),
-.BR psf (8).
+.TP
+\&.paprc
+file read to obtain printer name if not specified on command
+line
+.SH SEE\ ALSO
+\fBnbp_name\fR(3),
+\fBatalk_aton\fR(3),
+\fBlpd\fR(8),
+\fBpsf\fR(8).
+
-.TH PSORDER 1 "17 Dec 1991" "netatalk 1.2"
+.TH psorder 1 17\ Dec\ 1991 "Netatalk 2.0-alpha1"
.SH NAME
psorder \- PostScript pageorder filter
.SH SYNOPSIS
-.B psorder
-[
-.B -duf
-]
-.I sourcefile
+\fBpsorder\fR [\-duf] \fBsourcefile\fR
.SH DESCRIPTION
-.B 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
-.B psorder
-is to follow this specification.
-.LP
-If no source file is given, or if
-.I sourcefile
-is
-.RB ` - ',
-.B psorder
+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.
+.PP
+If no source file is given, or if \fIsourcefile\fR
+is `\fI\-\fR', psorder
reads from the standard input file.
-.br
.SH OPTIONS
-.TP
-.B \-d
-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
-.B \-u
-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
-.B \-f
-Force
-.B 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.
-.SH SEE ALSO
-.BR psf (8),
-.BR lpr (1).
+.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
+\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
+\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.
+.SH SEE\ ALSO
+\fBpsf\fR(8),
+\fBlpr\fR(1).
+
-.TH "timeout" "1" "19 Jul 2001" "netatalk 1.5pre7" "The Netatalk Project"
-
-.SH "NAME"
-.LP
+.TH timeout 1 19\ Jul\ 2001 "Netatalk 2.0-alpha1"The\ Netatalk\ Project
+.SH NAME
timeout \- Send a signal to a program after a certain time
-
-.SH "SYNTAX"
-.LP
-timeout [\-s \fIsignal\fP] \fIseconds\fP \fIprogram\fP [\fIargs\fP]
-
-.SH "DESCRIPTION"
-.LP
-\fBtimeout\fR executes a \fIprogram\fP (with arguments \fIargs\fP) and sends a
-\fIsignal\fP to it after a certain amount of \fIseconds\fP.
-
-.SH "OPTIONS"
-.LP
+.SH SYNTAX
+timeout [\-s \fIsignal\fR] \fIseconds\fR \fIprogram\fR [\fIargs\fR]
+.SH DESCRIPTION
+\fItimeout\fR executes a \fIprogram\fR (with arguments \fIargs\fR)
+and sends a \fIsignal\fR to it after a certain
+amount of \fIseconds\fR.
+.SH OPTIONS
+.TP
+\fB\-s\fR \fIsignal\fR
+Signal to send to the spawned process. This can be a numerical
+or symbolic ID. This defaults to \fBTERM\fR.
+.SH EXAMPLES
.TP
-\fB\-s\fR \fIsignal\fP
-Signal to send to the spawned process. This can be a numerical or symbolic ID.
-This defaults to \fBTERM\fR.
-
-.SH "EXAMPLES"
-.LP
-.TP
timeout 10 pap foo.ps
-Execute "pap foo.ps" and send a \fBSIGTERM\fR if \fBpap\fR doesn't return
-after 10 seconds.
-.TP
-timeout -s HUP 60 sh
+Execute "pap foo.ps" and send a SIGTERM
+if \fIpap\fR doesn't return after 10
+seconds.
+.TP
+timeout \-s HUP 60 sh
Spawn a shell and send a hangup signal after one minute.
-.TP
-timeout -s 9 10 evilprog
-Execute a program and \fBKILL\fR it if it doesn't quit after 10 seconds.
+.TP
+timeout \-s 9 10 evilprog
+Execute a program and \fIKILL\fR it
+if it doesn't quit after 10 seconds.
+
-.TH ATALK_ATON 3 "12 Jan 1994" "netatalk 1.3"
+.TH atalk_aton 3 12\ Jan\ 1994 "Netatalk 2.0-alpha1"
.SH NAME
atalk_aton \- AppleTalk address parsing
.SH SYNOPSIS
.nf
#include <sys/types.h>
#include <netatalk/at.h>
-.LP
-atalk_aton( cp, ata )
-char *cp;
-struct at_addr *ata;
+
.fi
+.sp 1
+.PP
+\fIatalk_aton\fR(* \fIcp\fR, struct at_addr * \fIata\fR);
.SH DESCRIPTION
-The
-.B 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.
-.SH SEE ALSO
-.BR atalk (4).
+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.
+.SH SEE\ ALSO
+\fBatalk\fR(4).
+
-.TH NBP_NAME 3 "12 Jan 1994" "netatalk 1.3"
+.TH nbp_name 3 12\ Jan\ 1994 "Netatalk 2.0-alpha1"
.SH NAME
nbp_name \- NBP name parsing
.SH SYNOPSIS
-.nf
-nbp_name( name, obj, type, zone )
-char *name, **obj, **type, **zone;
-.fi
+\fInbp_name\fR(char * \fIname\fR, char ** \fIobj\fR, char ** \fItype\fR, char ** \fIzone\fR));
.SH DESCRIPTION
-.B nbp_name()
-parses user supplied names into their component object, type, and
-zone.
-.BR obj ,
-.BR type ,
-and
-.B zone
-should be passed by reference, and should point to the caller's default
-values.
-.B nbp_name()
-will change the pointers to the parsed-out values.
-.B name
-is of the form
-.IB object : \c
-.IB type @ \c
-.IR zone ,
-where each of
-.IR object ,
-.BI : type ,
-and
-.BI @ zone
-replace
-.BR obj ,
-.BR type ,
-and
-.BR zone,
-respectively.
-.I type
-must be proceeded by
-.RB ` : ',
-and
-.I zone
-must be preceded by
-.RB ` @ '.
+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
-.BR afpd (8)'s
-.B -n
-option is parsed with
-.BR nbp_name() .
-The default value of
-.B obj
-is the first component of the machine's hostname (as returned by
-.BR gethostbyname (3)).
-The default value of
-.B type
-is ``AFPServer'', and of
-.B zone
-is ``*'', the default zone. To cause
-.B afpd
-to register itself in some zone other than the default, one would
-invoke it as
-.sp
-.RS
+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
+.PP
.nf
-afpd -n @some-other-zone
+afpd \-n @some\-other\-zone
.fi
-.RE
-.sp
-.B obj
-and
-.B type
+.PP
+\fIobj\fR and \fItype\fR
would retain their default values.
.SH BUGS
-.BR obj ,
-.BR type ,
-and
-.B zone
-return pointers into static area which may be over-written on each
-call.
+\fIobj\fR, \fItype\fR,
+and zone return pointers into static
+area which may be over\-written on each call.
+
-.TH ATALK 4F "17 Dec 1991" "netatalk 1.2"
+.TH atalk 4 17\ Dec\ 1991 "Netatalk 2.0-alpha1"
.SH NAME
atalk \- AppleTalk protocol family
.SH SYNOPSIS
-.B #include <sys/types.h>
-.br
-.B #include <netatalk/at.h>
+\fI#include <sys/types.h>\fR
+\fI#include <netatalk/at.h>\fR
.SH DESCRIPTION
The AppleTalk protocol family is a collection of protocols layered
above the Datagram Delivery Protocol (DDP), and using AppleTalk address
libraries; and ADSP is planned.
.SH ADDRESSING
AppleTalk addresses are three byte quantities, stored in network
-byte order. The include file
-.RB < netatalk/at.h >
+byte order. The include file <\fInetatalk/at.h\fR>
defines the AppleTalk address format.
-.LP
+.PP
Sockets in the AppleTalk protocol family use the following address
structure:
-.sp 1
-.RS
+.PP
+struct
+.PP
.nf
struct sockaddr_at {
- short sat_family;
- u_char sat_port;
- struct at_addr sat_addr;
- char sat_zero[ 8 ];
+short sat_family;
+u_char sat_port;
+struct at_addr sat_addr;
+char sat_zero[ 8 ];
};
.fi
-.RE
-.sp 1
-The port of a socket may be set with
-.BR bind (2).
-The node for
-.B bind
-must always be
-.BR ATADDR_ANYNODE :
-``this node.'' The net may be
-.B ATADDR_ANYNET
-or
-.BR ATADDR_LATENET .
-.B ATADDR_ANYNET
-coresponds to the machine's ``primary'' address (the first
-configured).
-.B ATADDR_LATENET
-causes the address in outgoing packets to be determined when a packet
-is sent, i.e. determined late.
-.B ATADDR_LATENET
-is equivalent to opening one socket for each network interface. The
-port of a socket and either the primary address or
-.B ATADDR_LATENET
-are returned with
-.BR getsockname (2).
-.SH SEE ALSO
-.\" .BR ddp (4P),
-.\" .BR atp (3N),
-.\" .BR asp (3N),
-.BR bind (2),
-.BR getsockname (2),
-.BR atalkd (8).
+.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).
+.SH SEE\ ALSO
+\fBbind\fR(2),
+\fBgetsockname\fR(2),
+\fBatalkd\fR(8).
+
-.\" $Id: AppleVolumes.default.5.tmpl,v 1.2.14.1 2003-11-30 22:07:36 rlewczuk Exp $
-.TH AppleVolumes.default 5 "20 September 2000" "netatalk 1.5"
-.UC 4
+.TH AppleVolumes.default 5 05\ January\ 2004 "Netatalk 2.0-alpha1"
.SH NAME
-AppleVolumes.default \- Configuration file used by \fBafpd\fR(8)
-to determine the shares made available through Appletalk
-
+AppleVolumes.default \- Configuration file used by afpd(8) to determine the shares made available through Appletalk
.SH DESCRIPTION
-\fB:ETCDIR:/AppleVolumes.default\fR is the configuration file used
-by afpd to determine what portions of the file system will be shared via
-Appletalk, as well as their behaviors.
-
-Any line not prefixed with \fB#\fR is interpreted. The configuration lines
-are composed like:
-
-.RS
-.sp
-.I path
-.B [
-.I chooser name
-.B ] [
-.I options
-.B ]
-
-.sp
-.RE
-The path name must be a fully qualified path name, or a path name using
-either the \fB~\fR shell shorthand or any of the substitution variables,
+\fB:ETCDIR:/AppleVolumes.default\fR is the
+configuration file used by afpd to determine what
+portions of the file system will be shared via Appletalk, as well as their
+behavior. Any line not prefixed with # is interpreted. The configuration
+lines are composed like:
+.PP
+path [ chooser name ] [ options ]
+.PP
+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.
-
-The chooser name is the name that appears in the Chooser on Macintoshes
-to represent the appropriate share. If there are spaces in the name, it
-should be in quotes (i.e. \fB"File Share"\fR). The chooser name may not
-exceed 27 characters in length, and cannot contain the \fB:\fR character.
-
+.PP
+The chooser name is the name that appears in the Chooser on
+Macintoshes to represent the appropriate share. If there are spaces in the
+name, it should be in quotes (i.e. "File Share"). The chooser name
+may not exceed 27 characters in length, and cannot contain the
+\fB\&':'\fR character.
+.RS
+\fBNote\fR
+.PP
+Each volume has to be configured on a \fBsingle\fR
+line.
+.RE
+.PP
The possible options and their meanings are:
-
-.TP
-.B allow:[users/groups]
-The allow option allows the users and groups that access a share to
-be specified. Users and groups are specified, delimited by commas. Groups
-are designated by a \fB@\fR prefix.
-
-\fIExample:\fR \fBallow:user1,user2,@group\fR
-
-.TP
-.B casefold:[option]
-The casefold option handles how casenames should be mangled. The available
-options are:
-
-\fBtolower\fR - Lowercases names in both directions.
-
-\fBtoupper\fR - Uppercases names in both directions.
-
-\fBxlatelower\fR - Client sees lowercase, server sees uppercase.
-
-\fBxlateupper\fR - Client sees uppercase, server sees lowercase.
-
-.TP
-.B cnidscheme:[scheme]
-Set the CNID database backend for the volume, default is [:DEFAULT_CNID_SCHEME:],
-available backends are [:COMPLETED_BACKENDS:].
-
-.TP
-.B codepage:[nls file]
-The codepage option loads a specific codepage from the nls directory.
-
-.TP
-.B dbpath:[path]
-Sets the database information to be stored in \fBpath\fR.
-
-.TP
-.B deny:[users/groups]
-The deny option specifies users and groups who are not allowed access
-to the share. It follows the same format as the \fBallow\fR option.
-
-.TP
-.B options:[option]
-This allows multiple options to be specified in a comma delimited format.
-The available options are:
-
-\fBcrlf\fR - Enables crlf translation for TEXT files.
-
-\fBdropbox\fR - Allows a volume to be declared as being a "dropbox." Note
-that netatalk must be compiled with dropkludge support for this to
-function.
-
-\fBlimitsize\fR - Hack for older Macintoshes using newer Appleshare
-clients to limit the disk size reporting to 2 GB.
-
-\fBmswindows\fR - Forces filename restrictions imposed by MS WinXX, and
-invokes the MS default codepage (iso8859-1) if one is not already
-specified.
-
-\fBnoadouble\fR - Forces afpd to not create .AppleDouble unless a resource
-fork needs to be created.
-
-\fBnofileid\fR - Don't advertise createfileid, resolveid and deleteid calls.
-
-\fBnohex\fR - Disables :hex translations for anything except dot files.
-This option makes the \fB/\fR character illegal.
-
-\fBnostat\fR - Don't stat volume path when enumerating volumes list.
-
-\fBpreexec_close\fR - A non-zero return code from preexec close
-the volume being mounted.
-
-\fBprodos\fR - Provides compatibility with Apple II clients.
-
-\fBro\fR - Specifies the share as being read only for all users.
-
-\fBroot_preexec_close\fR - A non-zero return code from root_preexec close
-the volume being mounted.
-
-\fBusedots\fR - Don't do :hex translation for dot files. This makes all
-files such as .Parent, .Apple* illegal. Dot files created on the server
-side will be invisible to the client.
-
-\fBupriv\fR - Use UNIX privilege (AFP3x).
-
-.TP
-.B password:[password]
-This option allows you to set a volume password, which can be a maximum
-of 8 characters long.
-
-.TP
-.B postexec:[command]
-Command to be run when the volume is closed, ignore for user defined volumes.
-
-.TP
-.B preexec:[command]
-Command to be run when the volume is mounted, ignore for user defined volumes.
-
-.TP
-.B rolist:[users/groups]
-Allows certain users and groups to have read-only access to a share.
-This follows the \fBallow\fR option format.
-
-.TP
-.B root_postexec:[command]
-Command to be run as root when the volume is closed, ignore for user defined volumes.
-
-.TP
-.B root_preexec:[command]
-Command to be run as root when the volume is opened, ignore for user defined volumes.
-
-.TP
-.B rwlist:[users/groups]
-Allows certain users and groups to have read/write access to a share.
-This follows the \fBallow\fR option format.
-
-.P
-The variables which can be used for subsitutions are:
-
-.TP
-.B $b
-basename of path
-
-.TP
-.B $c
+.TP
+adouble:\fI[v1/v2]\fR
+specify the format of the metadata files, which are used for
+saving Mac resource fork as well. Earlier versions used AppleDouble
+V1, the new default format is V2.
+.TP
+allow:\fI[users/groups]\fR
+The allow option allows the users and groups that access a
+share to be specified. Users and groups are specified, delimited by
+commas. Groups are designated by a @ prefix. Example:
+allow:user1,user2,@group
+.TP
+deny:\fI[users/groups]\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.
+.TP
+cnidscheme:\fI[backend]\fR
+set the CNID backend to be used for the volume, default is
+[:DEFAULT_CNID_SCHEME:] available schemes: [:COMPILED_BACKENDS:]
+.TP
+dbpath:\fI[path]\fR
+Sets the database information to be stored in path. You have
+to specifiy a writable location, even if the volume is read only.
+.TP
+maccharset:\fI[charset]\fR
+specifies the mac client codepage for this Volume, e.g.
+"MAC_ROMAN", "MAC_CYRILLIC". If not specified the
+setting from \fBafpd.conf\fR is inherited. This
+setting is only required if you need volumes, where the mac codepage
+differs from the one globally set in \fBafpd.conf\fR.
+.TP
+options:\fI[option]\fR
+This allows multiple options to be specified in a comma
+delimited format. The available options are:
+.RS
+.TP
+limitsize
+Limit disk size reporting to 2GB. This can be used for
+older Macintoshes using newer Appleshare clients.
+.TP
+ro
+Specifies the share as being read only for all users.
+\&.AppleDB has to be writeable, you can use the
+\fB\-dbpath\fR option to relocate it.
+.TP
+usedots
+Don't do :hex translation for dot files. note: when
+this option gets set, certain file names become illegal. These
+are .Parent and anything that starts with .Apple. Also, dot
+files created on the unix side are marked invisible.
+.TP
+root_preexec_close
+a non\-zero return code from root_preexec closes the
+volume being mounted.
+.TP
+preexec_close
+a non\-zero return code from preexec close the volume
+being mounted.
+.RE
+.TP
+password:\fI[password]\fR
+This option allows you to set a volume password, which can be
+a maximum of 8 characters long.
+.TP
+preexec:\fI[command]\fR
+command to be run when the volume is mounted, ignored for user
+defined volumes
+.TP
+postexec:\fI[command]\fR
+command to be run when the volume is closed, ignored for user
+defined volumes
+.TP
+root_preexec:\fI[command]\fR
+command to be run as root when the volume is mounted, ignored
+for user defined volumes
+.TP
+root_postexec:\fI[command]\fR
+command to be run as root when the volume is closed, ignored
+for user defined volumes
+.TP
+rolist:[\fBusers/groups\fR]
+Allows certain users and groups to have read\-only access to a
+share. This follows the allow option format.
+.TP
+rwlist:\fI[users/groups]\fR
+Allows certain users and groups to have read/write access to a
+share. This follows the allow option format.
+.TP
+veto:\fI[vetoed name]\fR
+hide files and directories,where the path matches one of the
+\&'/' delimited vetoed names. Matches are partial, e.g. path
+is \fB/abc/def/file\fR and veto:/abc/ will hide the
+file.
+.TP
+volcharset:\fI[charset]\fR
+specifies the volume codepage, e.g. "UTF8",
+"UTF8\-MAC", "ISO\-8859\-15". Defaults to
+"UTF8".
+.SH VARIABLE\ SUBSTITUTIONS
+You can use variables in both volume path and volume name.
+.TP
+1.
+if you specify an unknown variable, it will not get converted.
+.TP
+2.
+if you specify a known variable, but that variable doesn't
+have a value, it will get ignored.
+.PP
+The variables which can be used for substitutions are:
+.TP
+$b
+basename
+.TP
+$c
client's ip or appletalk address
-
-.TP
-.B $d
+.TP
+$d
volume pathname on server
-
-.TP
-.B $f
+.TP
+$f
full name (contents of the gecos field in the passwd file)
-
-.TP
-.B $g
+.TP
+$g
group name
-
-.TP
-.B $h
+.TP
+$h
hostname
-
-.TP
-.B $i
-client IP without tcp port or appletalk network
-
-.TP
-.B $s
+.TP
+$i
+client's ip, without port
+.TP
+$s
server name (this can be the hostname)
-
-.TP
-.B $u
+.TP
+$u
user name (if guest, it is the user that guest is running as)
-
-.TP
-.B $v
+.TP
+$v
volume name (either ADEID_NAME or basename of path)
-
-.TP
-.B $z
+.TP
+$z
appletalk zone (may not exist)
+.TP
+$$
+prints dollar sign ($)
+.SH CNID\ BACKENDS
+The AFP protocol mostly refers to files and directories by ID and
+not by name. Netatalk needs a way to store these ID's in a persistent
+way, to achieve this several different CNID backends are available. The
+CNID Databases are by default located in the .\fBAppleDB\fR
+folder in the volume root.
+.TP
+cdb
+"Concurrent database", backend is based on
+sleepycat's Berkely DB. With this backend several
+afpd deamons access the CNID database directly.
+Berkeley DB locking is used to synchronize access, if more than one
+afpd process is active for a volume. The drawback
+is, that the crash of a single afpd process might
+corrupt the database.
+.TP
+dbd
+Access to the CNID database is restricted to a the
+cnid_metad daemon process. afpd
+processes communicate with the daemon for database reads and
+updates. If built with Berkeley DB transactions the probability for
+database corruption is practically zero, but performance can be
+slower than with \fBcdb\fR
+.TP
+last
+This backend is an exception, in terms of ID persistency.
+ID's are only valid for the current session. This is basically
+what afpd did in the 1.5 (and 1.6) versions. This
+backend is still available, as it is useful for e.g. sharing cdroms.
+
+\fBWarning\fR: It is
+\fINOT\fR recommended to use this backend for volumes
+anymore, as afpd now relies heavily on a
+persistent ID database. Aliases will likely not work and filename
+mangling is not supported.
+.PP
+Even though ./configure \-\-help might show that
+there are other CNID backends available, be warned those are likely broken
+or mainly used for testing. Don't use them unless you know what
+you're doing, they may be removed without further notice from future
+versions.
+.SH CHARSET\ OPTIONS
+With OS X Apple introduced the AFP3 protocol. One of the most
+important changes was that AFP3 uses unicode names encoded as UTF\-8
+decomposed. Previous AFP/OS versions used codepages, like MacRoman,
+MacCentralEurope, etc.
+.PP
+afpd needs a way to preserve extended macintosh
+characters, or characters illegal in unix filenames, when saving files on
+a unix filesystem. Earlier versions used the the so called CAP encoding.
+An extended character (>0x7F) would be converted to a :xx sequence,
+e.g. the Apple Logo (MacRoman: 0XF0) was saved as \fB:f0\fR.
+Some special characters will be converted as to :xx notation as well.
+\&'\fB/\fR' will be encoded to \fB:2f\fR,
+if \fB\-usedots\fR is not specified, a leading dot '\fB.\fR'
+will be encoded as \fB:2e\fR.
+.PP
+This version now uses UTF\-8 as the default encoding for names.
+Special characters, like '\fB/\fR' and a leading
+\&'\fB.\fR' will still be CAP style encoded .
+.PP
+The \fB\-volcharset\fR option will allow you to select
+another volume encoding. E.g. for western users another useful setting
+could be \-volcharset ISO\-8859\-15. apfd will accept any
+\fBiconv\fR(1)
+provided charset. If a character cannot be converted from the mac codepage
+to the selected volcharset, afpd will save it as a CAP encoded character.
+For AFP3 clients, afpd will convert the UTF\-8 character
+to \fB\-maccharset\fR first. If this conversion fails,
+you'll receive a \-50 error on the mac.
+.PP
+\fINote\fR: Whenever you can, please stick with the
+default UTF\-8 volume format.
+.SH COMPATIBILITY\ WITH\ EARLIER\ VERSIONS
+To use a volume created with an earlier afpd
+version, you'll have to specify the following options:
+.PP
+\fBuse a 1.x style volume\fR
+.PP
+.nf
+/path/to/volume "Volname" adouble:v1 volcharset:ASCII
+.fi
+.PP
+In case you used an NLS you could try using a compatible iconv
+charset for \fB\-volcharset\fR.
+.PP
+\fBuse a 1.x style volume, created with maccode.iso8859\-1\fR
+.PP
+.nf
+/path/to/volume "Volname" adouble:v1 volcharset:ISO\-8859\-1
+.fi
+.PP
+You should consider converting old style volumes to the new
+UTF\-8/AD2 format. The safest way to do this, is to create a new volume
+with the default options and copy the files between this volumes with a
+mac.
+.PP
+\fINote\fR: Using above example options will allow
+you to downgrade to 1.x netatalk again.
+.PP
+\fINote\fR: Some 1.x NLS files used non standard
+mappings, e.g. \fBmaccode.iso8859\-1.adapted\fR. This is not
+supported anymore. You'll have to copy the contents of those volumes
+files to a Mac and then back to the netatalk server, preferably to an
+UTF\-8 volume.
+.SH ADVANCED\ OPTIONS
+The following options should only be used after serious
+consideration. Be sure you fully understood the, sometimes complex,
+consequences, before using them.
+.TP
+casefold:\fB[option]\fR
+The casefold option handles, if the case of filenames should
+be changed. The available options are:
+
+\fBtolower\fR \- Lowercases names in both
+directions.
+
+\fBtoupper\fR \- Uppercases names in both
+directions.
+
+\fBxlatelower\fR \- Client sees lowercase, server
+sees uppercase.
+
+\fBxlateupper\fR \- Client sees uppercase, server
+sees lowercase.
+.TP
+options:[\fBoption\fR]
+This allows multiple options to be specified in a comma
+delimited format. The available options are:
+.RS
+.TP
+crlf
+Enables crlf translation for TEXT files.
+.TP
+dropbox
+Allows a volume to be declared as being a
+"dropbox." Note that netatalk must be compiled with
+dropkludge support for this to function. \fIWarning\fR:
+This option is deprecated and might not work as expected.
+.TP
+mswindows
+Forces filename restrictions imposed by MS WinXX.
+\fIWarning\fR: This is \fINOT\fR
+recommened for volumes mainly used by Macs. Please make sure
+you fully understand this option before using it.
+.TP
+noadouble
+Forces afpd to not create
+\&.AppleDouble unless a resource fork needs to be created.
+.TP
+nodev
+always use 0 for device number, helps when the device
+number is not constant across a reboot, cluster, ....
+.TP
+nofileid
+don't advertise createfileid, resolveid, deleteid
+calls
+.TP
+nohex
+Disables :hex translations for anything except dot
+files. This option makes the \fB'/\fR'
+character illegal.
+.TP
+prodos
+Provides compatibility with Apple II clients.
+.TP
+nostat
+don't stat volume path when enumerating volumes
+list, useful for automounting or volumes created by a preexec
+script.
+.TP
+upriv
+use AFP3 unix privileges
+.RE
+.SH SEE\ ALSO
+\fBafpd.conf\fR(5),
+\fBafpd\fR(8)
-.TP
-.B $$
-prints dollar sign (\fb$\fR)
-
-.SH SEE ALSO
-afpd(8)
-.\" $Id: afpd.conf.5.tmpl,v 1.3 2002-05-03 22:51:34 jmarcus Exp $
-.TH afpd.conf 5 "28 September 2000" "netatalk 1.5"
-.UC 4
+.TH afpd.conf 5 05\ Jan\ 2004 "Netatalk 2.0-alpha1"
.SH NAME
-afpd.conf \- Configuration file used by \fBafpd\fR(8)
-to determine the setup of its file sharing services
-
+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.
-
-Any line not prefixed with \fB#\fR is interpreted. The configuration lines
-are composed like:
-
-.RS
-.sp
-.I server name
-.B [
-.I options
-.B ]
-
-.sp
+\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 \- is used instead of a
+server name, the default server is specified. Server names must be quoted
+if they contain spaces. 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
+\fBNote\fR
+.PP
+Each server has to be configured on a \fBsingle\fR line.
.RE
-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.
-
-The path name must be a fully qualified path name, or a path name using
-either the \fB~\fR shell shorthand or any of the substitution variables,
-which are listed below.
-
-The possible options and their meanings are:
-.TP
-.I AppleVolumes Files
-
-.TP
-.B -defaultvol [path]
-Specifies path to AppleVolumes.default file (default is
+The possible options and
+their meanings are:
+.SH APPLEVOLUMES\ FILES
+.TP
+\-defaultvol \fI[path]\fR
+Specifies path to AppleVolumes.default file (default is
\fB:ETCDIR:/AppleVolumes.default\fR).
-
-.TP
-.B -nlspath [path]
-Specifies the path to the code pages (default is \fB:ETCDIR:/nls\fR).
-
-.TP
-.B -systemvol [path]
-Specifies path to AppleVolumes.system file (default is
+.TP
+\-systemvol \fI[path]\fR
+Specifies path to AppleVolumes.system file (default is
\fB:ETCDIR:/AppleVolumes.system\fR).
-
-.TP
-.B -[no]uservol
-Enables or disables reading of the users' individual volumes file
-entirely.
-
-.TP
-.B -[no]uservolfirst
-Enables or disables reading of the users' individual volumes file
-before processing the global \fBAppleVolumes.default\fR file.
-
-.TP
-.I Authentication Methods
-
-.TP
-.B -uamlist [uams list]
+.TP
+\-[no]uservol
+Enables or disables reading of the users' individual
+volumes file entirely.
+.TP
+\-[no]uservolfirst
+Enables or disables reading of the users' individual
+volumes file before processing the global \fBAppleVolumes.default\fR
+file.
+.SH AUTHENTICATION\ METHODS
+.TP
+\-uamlist \fI[uams list]\fR
Comma separated list of UAMs. (The default is
-\fBuams_guest.so,uams_passwd.so,uams_dhx_passwd.so\fR).
-The most commonly used UAMs are:
-
-\fBuams_dhx_passwd.so or uams_dhx_pam.so\fR - allows logins
-using Diffie-Hellman eXchange (DHX)
-
-\fBuams_guest.so\fR - allows guest logins
-
-\fBuams_passwd.so or uams_pam.so\fR - allows logins with clear
-text passwords
-
-\fBuams_randum.so\fR - allows Random Number and Two-Way Random
-Number Exchange for authentication (requires \fB:ETCDIR:/afppaswd\fR
-file)
+uams_guest.so,uams_clrtxt.so,uams_dhx.so).
-.TP
-.B -uampath [path]
-Sets the default path for UAMs for this server (default is
-:ETCDIR:/uams).
-
-.TP
-.I Password Options
-
-.TP
-.B -loginmaxmail [number]
-Sets the maximum number of failed logins, if supported by the UAM
-
-.TP
-.B -passwdfile [path]
-Sets the path to the Randnum passwd file for this server (default is
-\fB:ETCDIR:/afppasswd\fR).
-
-.TP
-.B -passwdminlen [number]
+The most commonly used UAMs are:
+.RS
+.TP
+uams_guest.so
+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
+/usr/local/netatalk\-head\-testing//etc/netatalk/afppaswd file)
+.TP
+uams_dhx.so
+(uams_dhx_pam.so or uams_dhx_passwd.so) Allow
+Diffie\-Hellman eXchange (DHX) for authentication.
+.TP
+uam_gss.so
+Allow Kerberos V for authetication (optional)
+.RE
+.TP
+\-uampath \fI[path]\fR
+Sets the default path for UAMs for this server (default is
+/usr/local/netatalk\-head\-testing//etc/netatalk/uams).
+.TP
+\-k5keytab \fI[path]\fR, \-k5service \fI[service]\fR, \-k5realm \fI[realm]\fR
+These are required if the server supports the Kerberos 5
+authentication UAM.
+.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
+To be able to serve AFP3 and older clients at the same time,
+afpd needs to be able to convert betweend 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 filename to the clients codepage
+for OS9 and Classic, i.e. for authentication and SIGUSR2 messaging.
+This will also be the default for the volumes maccharset. Defaults
+to MAC_ROMAN.
+.SH PASSWORD\ OPTIONS
+.TP
+\-loginmaxmail [number]
+Sets the maximum number of failed logins, if supported by the
+UAM
+.TP
+\-passwdfile [path]
+Sets the path to the Randnum UAM passwd file for this server
+(default is
+/usr/local/netatalk\-head\-testing//etc/netatalk/afppasswd).
+.TP
+\-passwdminlen [number]
Sets the minimum password length, if supported by the UAM
-
-.TP
-.B -[no]savepassword
-Enables or disables the ability of clients to save passwords locally
-
-.TP
-.B -[no]setpassword
-Enables or disables the ability of clients to change their passwords
-
-
-.TP
-.I Transport Protocols
-
-.TP
-.B -[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
-.B -[no]tcp
-Enables or disables AFP-over-TCP
-
-.TP
-.I Transport Options
-
-.TP
-.B -admingroup [group]
-Allows users of a certain group to be seen as the superuser when they
-log in. This option is disabled, by default.
-
-.TP
-.B -ddpaddr [ddp address]
-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 on a multihomed host.
-
-.TP
-.B -fqdn [name:port]
-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.
-
-.TP
-.B -ipaddr [ip address]
-Specifies the IP that the server should respond to (the default is the
-first IP address of the system). This option also allows one machine to
-advertise TCP/IP for another machine.
-
-.TP
-.B -port [port number]
-Allows a different TCP port to be specified for AFP-over-TCP. The default
-is 548.
-
-.TP
-.B -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
-.B -server_quantum [number]
-This specifoes the DSI server quantum. The minimum value is 1 MB. 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).
-
-.TP
-.B -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.
-
-.TP
-.I Miscellaneous Options
-
-.TP
-.B -guestname [name]
-Specifies the user that guests should use (default is \fB"nobody"\fR). The
-name should be quoted.
-
-.TP
-.B -icon
-Use the platform-specific icon
-
-.TP
-.B -loginmsg [message]
-Sets a message to be displayed when clients logon to the server. The
-message should be quoted.
-
-.TP
-.B -nodebug
+.TP
+\-[no]savepassword
+Enables or disables the ability of clients to save passwords
+locally
+.TP
+\-[no]setpassword
+Enables or disables the ability of clients to change their
+passwords
+.SH TRANSPORT\ PROTOCOLS
+.TP
+\-[no]ddp
+Enables or disables AFP\-over\-Appletalk. If \-proxy is
+specified, you must instead use \-uamlist "" to prevent DDP
+connections from working.
+.TP
+\-[no]tcp
+Enables or disables AFP\-over\-TCP
+.TP
+\-transall
+Make both available (default)
+.SH TRANSPORT\ OPTIONS
+.TP
+\-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
+on a multihomed host.
+.TP
+\-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.
+.TP
+\-ipaddr \fI[ip address]\fR
+Specifies the IP that the server should respond to (the
+default is the first IP address of the system). This option also
+allows one machine to advertise TCP/IP for another machine.
+.TP
+\-port \fI[port number]\fR
+Allows a different TCP port to be specified for AFP\-over\-TCP.
+The default is 548.
+.TP
+\-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 \-uamlist
+"".
+.TP
+\-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).
+.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.
+.SH MISCELLANEOUS\ OPTIONS
+.TP
+\-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
+\-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
+\fBNote\fR
+
+\fB\-authprintdir\fR will only work for clients
+connecting via DDP. Most modern Clients will use TCP.
+.RE
+.TP
+\-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!
+.TP
+\-cnidserver \fI[ipaddress:port]\fR
+Specifies the IP address and port of a cnid_metad server,
+required for CNID bdb backend.
+.TP
+\-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
+\-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
+\-nodebug
Disables debugging
-
-.TP
-.B -tickleval [number]
+.TP
+\-sleep \fI[number]\fR
+AFP 3.x waits number hours before
+disconnecting clients in sleep mode. Default is 10 hours
+.TP
+\-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.
+
+Examples: three servers running on one machine: first
+\-signature user:USERS second \-signature user:USERS third \-signature
+user:ADMINS
+
+First two servers will act as one logical AFP service \- 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 instancesto have
+the same signature and thus cause clients to be redirected
+automatically to server (s)he logged in first.
+.SH LOGGING\ OPTIONS
+.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, AFPDaemon loglevels:
+LOG_SEVERE, LOG_ERROR, LOG_WARN, LOG_NOTE, LOG_INFO, LOG_DEBUG,
+LOG_DEBUG6, LOG_DEBUG7, LOG_DEBUG8, LOG_DEBUG9, LOG_MAXDEBUG
+
+Example: \-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"
+.SH DEBUG\ OPTIONS
+These options are useful for debugging only.
+.TP
+\-tickleval \fI[number]\fR
Sets the tickle timeout interval (in seconds).
+.TP
+\-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 in
+2 minutes.
+.SH EXAMPLES
+\fBDefault configuration\fR
+.PP
+.nf
+\- \-transall \-uamlist uams_clrtxt.so,uams_dhx.so,uams_guest.so
+.fi
+.PP
+\fBMacCyrillic setup / UTF8 unix locale\fR
+.PP
+.nf
+\- \-transall \-maccodepage mac_cyrillic \-unixcodepage utf8
+.fi
+.PP
+\fBSetup for Kerberos V auth\fR
+.PP
+.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
+.fi
+.PP
+\fBThree servers on one machine\fR
+.PP
+.nf
+"Guest Server" \-uamlist uams_guest.so \-loginmesg "Welcome guest!"
+"User Server" \-uamlist uams_dhx.so \-port 12000
+"special" \-notcp \-defaultvol <path> \-systemvol <path>
+.fi
+.SH SEE\ ALSO
+\fBafpd\fR(8),
+\fBAppleVolumes.default\fR(5)
-.SH SEE ALSO
-afpd(8), AppleVolumes.default(5)
-.\" $Id: atalkd.conf.5.tmpl,v 1.1 2000-09-22 20:01:39 rufustfirefly Exp $
-.TH atalkd.conf 5 "22 September 2000" "netatalk 1.5"
-.UC 4
+.TH atalkd.conf 5 22\ September\ 2000 "Netatalk 2.0-alpha1"
.SH NAME
-atalkd.conf \- Configuration file used by \fBatalkd\fR(8)
-to determine the interfaces used by the master Netatalk daemon
-
+atalkd.conf \- Configuration file used by atalkd(8) to determine the interfaces used by the master Netatalk daemon
.SH DESCRIPTION
-\fB:ETCDIR:/atalkd.conf\fR is the configuration file used
-by atalkd to configure the Appletalk interfaces and their behavior
-
-Any line not prefixed with \fB#\fR is interpreted. The configuration lines
-are composed like:
-
-.RS
-.sp
-.I interface
-.B [
-.I options
-.B ]
-
-.sp
-.RE
-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.
-
-The interface is the network interface that this to work over, such as
-\fBeth0\fR for Linux, or \fBle0\fR for Sun.
-
+\fI:ETCDIR:/atalkd.conf\fR is the
+configuration file used by atalkd to configure the Appletalk interfaces
+and their behavior
+.PP
+Any line not prefixed with \fI#\fR is
+interpreted. The configuration lines are composed like:
+.PP
+\fInterface\fR \fI[\fR
+\fIoptions\fR \fI]\fR
+.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.
+.PP
+The interface is the network interface that this to work over, such
+as \fIeth0\fR for Linux, or \fIle0\fR
+for Sun.
+.PP
The possible options and their meanings are:
-
-.TP
-.B -addr net.node
-Allows specification of the net and node numbers for this interface,
-specified in Appletalk numbering format (example: \fI-addr 66.6\fR).
-
-.TP
-.B -dontroute
-Disables Appletalk routing. It is the opposite of \fB-router\fR.
-
-.TP
-.B -net first[-last]
+.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
+\fB\-dontroute\fR
+Disables Appletalk routing. It is the opposite of
+\fB\-router\fR.
+.TP
+\fB\-net first[\-last]\fR
Allows the available net to be set, optionally as a range.
+.TP
+\fB\-phase ( 1 | 2 )\fR
+Specifies the Appletalk phase that this interface is to use
+(either Phase 1 or Phase 2).
+.TP
+\fB\-router\fR
+Like \fB\-seed\fR, but allows single interface
+routing. It is the opposite of \fB\-dontroute\fR.
+.TP
+\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
+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.
+.SH SEE\ ALSO
+\fBatalkd\fR(8)
-.TP
-.B -phase ( 1 | 2 )
-Specifies the Appletalk phase that this interface is to use (either Phase
-1 or Phase 2).
-
-.TP
-.B -router
-Like \fB-seed\fR, but allows single interface routing. It is the opposite
-of \fB-dontroute\fR.
-
-.TP
-.B -seed
-The seed option only works if you have multiple interfaces. It also causes
-all missing arguments to be automagically configured from the network.
-
-.TP
-.B -zone zonename
-Specifies a specific zone that this interface should appear on (example:
-\fI-zone "Parking Lot"\fR). Please note that zones with spaces and other
-special characters should be enclosed in parentheses.
-
-.SH SEE ALSO
-atalkd(8)
-.\" $Id: netatalk.conf.5.tmpl,v 1.2 2000-09-28 16:49:21 rufustfirefly Exp $
-.TH netatalk.conf 5 "28 September 2000" "netatalk 1.5"
-.UC 4
+.TH netatalk.conf 5 28\ September\ 2000 "Netatalk 2.0-alpha1"
.SH NAME
-netatalk.conf \- Configuration file used by \fBnetatalk\fR(8)
-to determine its general configuration
-
+netatalk.conf \- Configuration file used by netatalk(8) to determine its general configuration
.SH DESCRIPTION
-\fB:ETCDIR:/netatalk.conf\fR is the configuration file used
-by afpd to determine what portions of the file system will be shared via
-Appletalk, as well as their behaviors.
-
-Any line not prefixed with \fB#\fR is interpreted. The configuration lines
-are composed like:
-
-.RS
-.sp
-.I option
-.B =
-.I value
-
-.sp
-.RE
+\fI:ETCDIR:/netatalk.conf\fR is the
+configuration file used by afpd to determine what portions of the file
+system will be shared via Appletalk, as well as their behaviors.
+.PP
+Any line not prefixed with \fI#\fR is
+interpreted. The configuration lines are composed like:
+.PP
+\fIoption\fR \fI=\fR
+\fIvalue\fR
+.PP
The possible options and their meanings are:
-
-.TP
-.B AFPD_GUEST
+.TP
+\fIAFPD_GUEST\fR
Sets the id of the guest user to a local user on the system.
-
-.TP
-.B AFPD_MAX_CLIENTS
-Sets the maximum number of clients that can simultaneously connect to
-the server.
-
-.TP
-.B AFPD_RUN
-Enables the afpd daemon if set to "yes". This should be enabled if you
-are planning on using netatalk as a file server.
-
-.TP
-.B AFPD_UAM_LIST
-Sets the default UAMs for afpd (and papd, if printer authentication is
-compiled in) to use.
-
-\fIExample:\fR
-\fBAFPD_UAMLIST\fR=\fB"-U uams_guest.so,uams_randnum.so"\fR
-
-.TP
-.B ATALK_BGROUND
-"yes" will set netatalk to initialize in the background, and "no" will
-cause normal initialization.
-
-.TP
-.B ATALK_NAME
+.TP
+\fIAFPD_MAX_CLIENTS\fR
+Sets the maximum number of clients that can simultaneously
+connect to the server.
+.TP
+\fIAFPD_RUN\fR
+Enables the afpd daemon if set to "yes". This should
+be enabled if you are planning on using netatalk as a file server.
+.TP
+\fIAFPD_UAM_LIST\fR
+Sets the default UAMs for afpd (and papd, if printer
+authentication is compiled in) to use.
+
+\fIExample:\fR \fIAFPD_UAMLIST\fR=\fI"\-U uams_guest.so,uams_randnum.so"\fR
+.TP
+\fIATALK_BGROUND\fR
+"yes" will set netatalk to initialize in the
+background, and "no" will cause normal initialization.
+.TP
+\fIATALK_NAME\fR
Sets the machines' Appletalk name.
-
-.TP
-.B ATALK_ZONE
+.TP
+\fIATALK_ZONE\fR
Sets the machines' Appletalk zone.
+.TP
+\fIATALKD_RUN\fR
+Enables the atalkd daemon if set to "yes". This should
+be enabled if you are planning on providing Appletalk services.
+.TP
+\fIPAPD_RUN\fR
+Enables the papd daemon if set to "yes". This should
+be enabled if you are planning on using netatalk as a print server.
+.SH SEE\ ALSO
+\fBatalkd\fR(8),
+\fBatalkd.conf\fR(5)
-.TP
-.B ATALKD_RUN
-Enables the atalkd daemon if set to "yes". This should be enabled if
-you are planning on providing Appletalk services.
-
-.TP
-.B PAPD_RUN
-Enables the papd daemon if set to "yes". This should be enabled if you
-are planning on using netatalk as a print server.
-
-.SH SEE ALSO
-atalkd(8), atalkd.conf(5)
-.\" $Id: papd.conf.5.tmpl,v 1.2 2002-03-19 23:23:53 morgana Exp $
-.TH papd.conf 5 "26 September 2000" "netatalk 1.5"
-.UC 4
+.TH papd.conf 5 26\ September\ 2000 "Netatalk 2.0-alpha1"
.SH NAME
-papd.conf \- Configuration file used by \fBpapd\fR(8)
-to determine the configuration of printers used by the Netatalk printing
-daemon
-
+papd.conf \- Configuration file used by papd(8) to determine the configuration of printers used by the Netatalk printing daemon
.SH DESCRIPTION
-\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.
-
-Any line not prefixed with \fB#\fR is interpreted. The configuration lines
-are composed like:
-
-.RS
-.sp
-.I printername:[options]
-
-.sp
-.RE
-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\\\fR.
-
-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). If more than 15
-printers are defined, you should explicitly define the zone for each printer.
-Otherwise, the Mac Chooser not show all the printers.
-
-The possible options are colon delimited (\fB:\fR), and lines must be
-terminated with colons. The possible options and flags are:
-
-.TP
-.B am=(uams list)
-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
+\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.
+.PP
+Any line not prefixed with \fI#\fR is
+interpreted. The configuration lines are composed like:
+.PP
+\fIprintername:[options]\fR
+.PP
+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). If more than 15 printers are defined,
+you should explicitly define the zone for each printer. Otherwise, the Mac
+Chooser not show all the printers.
+.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.
-
-.TP
-.B au
-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
-.B op=(operator)
+.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
+\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 printer name)\fR
+Sets the \fIlpd\fR printer that this
+is spooled to.
+.SH SEE\ ALSO
+\fBpapd\fR(8),
+\fBatalkd.conf\fR(5),
+\fBlpd\fR(8)
-.TP
-.B pa=(appletalk address)
-Allows specification of Appletalk addresses. Usually not needed.
-
-.TP
-.B pd=(path to ppd file)
-Specifies a particular PPD (printer description file) to associate with
-the selected printer.
-
-.TP
-.B pr=(lpd printer name)
-Sets the \fBlpd\fR printer that this is spooled to.
-
-.SH SEE ALSO
-papd(8), atalkd.conf(5), lpd(8)
-.TH AFPD 8 "23 Feb 1999" ":NETATALK_VERSION:"
-
+.TH afpd 8 06\ Jan\ 2004 "Netatalk 2.0-alpha1"
.SH NAME
afpd \- AppleTalk Filing Protocol daemon
.SH SYNOPSIS
-.B afpd
-[
-.B -duptDTvI
-]
-[
-.B -f
-.I defaultvolumes
-]
-[
-.B -s
-.I systemvolumes
-]
-[
-.B -n
-.I nbpname
-]
-[
-.B -c
-.I maxconnections
-]
-[
-.B -g
-.I guest
-]
-[
-.B -P
-.I pidfile
-]
-[
-.B -S
-.I port
-]
-[
-.B -L
-.I message
-]
-[
-.B -F
-.I config
-]
-[
-.B -U
-.I uams
-]
-[
-.B -m
-.I umask
-]
+\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
-.B afpd
-provides an AppleTalk Filing Protocol (AFP)
-interface to the Unix file system. It is normally started at boot time
-from
-.BR /etc/rc .
+afpd 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
-.B :ETCDIR:/AppleVolumes.system
-and one of
-.BR :ETCDIR:/AppleVolumes.default ,
-.BR ~/AppleVolumes ,
-or
-.BR ~/.AppleVolumes .
-.LP
-The
-.B AppleVolumes
-files is used to specify volumes to mount and file name extension mappings.
-It is formatted as follows, one specification per line:
-.RS
-.sp
-.I pathname
-[
-.I volumename
-]
-.br
-.RI . extension
-[
-.I type
-[
-.I creator
-]
-]
-.sp
-.RE
-If
-.I volumename
-is unspecified, the last component of
-.I pathname
-is used. No two volumes may have the same name. If
-.I type
-is unspecified
-.RB ' ???? '
-is used. If
-.I creator
-is unspecified
-.RB ' UNIX '
-is used. The extension
-.RB ' . '
-sets the default creator and type for otherwise untyped Unix files.
-Blank lines and lines beginning with `#' are ignored.
+\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
-.B \-d
-Specifies that the daemon not fork, and that a trace of all AFP
-commands be written to stdout.
-.TP
-.BI \-f " defaultvolumes"
-Specifies that
-.I defaultvolumes
-should be read for a list of default volumes to offer, instead of
-.BR :ETCDIR:/AppleVolumes.default .
-.TP
-.BI \-s " systemvolumes"
-Specifies that
-.I systemvolumes
-should be read for a list of volume that all users will be offered,
-instead of
-.BR :ETCDIR:/AppleVolumes.system .
-.TP
-.B \-u
-Read the user's
-.B AppleVolumes
-file first. This option causes volume names in the user's
-.B AppleVolumes
-file to override volume names in the system's
-.B AppleVolumes
-file. The default is to read the system
-.B AppleVolumes
-file first. Note that this option doesn't effect the precendence of
-filename extension mappings: the user's AppleVolumes file always has
-precedence.
-.TP
-.BI \-n " nbpname"
-Specifies that
-.I nbpname
-should be used for NBP registration, instead of the first component of
-the hostname in the local zone.
-.TP
-.BI \-c " maxconnections"
-Specifies the maximum number of connections to allow for this
-.BR afpd .
-The default is 5.
-.TP
-.BI \-g " guest"
-Specifies the name of the guest account. The default is ``nobody''.
-.TP
-.BI \-P " pidfile"
-Specifies the file in which
-.B afpd
-stores its process id.
-.TP
-.B \-p
-Prevents clients from saving their passwords. (Equivalent to
-.I \-nosavepasswd
-in
-.BR afpd.conf .)
-.TP
-.B \-t
+.TP
+\-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
+\-p
+Prevents clients from saving their passwords. (Equivalent to \-\fBnosavepasswd\fR
+in \fBafpd.conf\fR.)
+.TP
+\-t
Allows clients to change their passwords. (Equivalent to
-.I \-setpasswd
-in
-.BR afpd.conf .)
-.TP
-.B \-D
+\fB\-setpasswd\fR in \fBafpd.conf\fR.)
+.TP
+\-D
Use DDP (AppleTalk) as transport protocol. (Equivalent to
-.I \-ddp
-in
-.BR afpd.cond .)
-.TP
-.B \-T
+\fB\-ddp\fR in \fBafpd.cond\fR.)
+.TP
+\-T
Use TCP/IP as transport protocol. (Equivalent to
-.I \-tcp
-in
-.BR afpd.conf .)
-.TP
-.BI \-S " port"
-Specifies the port to register with when doing AFPoverTCP. Defaults to
-.IR 548 .
-(Equivalent to
-.I -port
-in
-.BR afpd.conf .)
-.TP
-.BI \-L " message"
-Specifies the login message that will be sent to clients. (Equivalent to
-.I \-loginmsg
-in
-.BR afpd.conf .)
-.TP
-.BI \-F " config"
-Specifies the configuration file to use. (Defaults to
-.IR :ETCDIR:/afpd.conf .)
-.TP
-.BI \-U " uams"
-Comma-separated list of UAMs to use for the authentication process.
-(Equivalent to
-.I -uamlist
-in
-.BR afpd.conf .)
-.TP
-.B \-I
-Use a platform specific icon. (Equivalent to
-.I \-icon
-in
-.BR afpd.conf .)
-.TP
-.BR \-m " umask"
-Use this umask for the creation of folders in Netatalk.
-.TP
-.B \-v
+\fB\-tcp\fR in \fBafpd.conf\fR.)
+.TP
+\-v
Print version information and exit.
-.SH AUTHENTICATION
-.B afpd
-currently understands three User Authentication Methods (UAMs):
-.BR NoUserAuthent ,
-or guest,
-.B Cleartxt
-.BR passwrd ,
-and
-.B Kerberos
-.BR IV .
-If a user uses
-.BR NoUserAuthent ,
-s/he will only be offered default volumes to mount, and will only be able
-to read and write files that are permitted to the guest user. The
-.B -G
-option disables
-.BR NoUserAuthent .
-With
-.B Cleartxt passwd
-and
-.B Kerberos
-.BR IV ,
-.B afpd
-offers the user all volumes listed in
-.BR ~/AppleVolumes .
-The user may also read and write all files that s/he normally could.
-.B Cleartxt passwd
-is not recommended for AFS use.
-.B Kerberos IV
-is recommended for AFS use.
-A forth, depricated UAM is also included in the distribution,
-.B AFS
-.BR Kerberos .
-.SH CAVEATS
-.BR afpd 's
-Directory IDs are only fixed for the duration of a session. This means
-that Mac aliases won't work correctly in all cases.
-.LP
-If a user renames a folder that has an application as its progeny, the
-.B APPL
-mapping for the application will not longer be available. This implies
-that double-clicking on one of the application's documents will no
-longer launch the application. The
-.B APPL
-mapping will be rebuilt by the mac, the next time the Finder see the
-application.
-.LP
-If
-.B afpd
-is configured to downcase Macintosh filenames, Unix filenames with
-mixed case will be unavailable.
-.LP
-If carriage return/line feed translation is enabled, it is not
-safe to copy Unix binaries to a Macintosh.
-.LP
-It is not possible to move directories between devices.
-.LP
-When mounting the parent of an existing volume, the desktop database of
-the existing volume will not be available to the parent volume. The
-.B APPL
-mappings and icons of applications with the
-.B BNDL
-bit set will be generated in the parent volume as the applications are
-seen by the Finder.
-.LP
-If a user edits his
-.B ~/AppleVolumes
-so that his home directory is no longer offered, he will no longer be able
-to edit his
-.B ~/AppleVolumes
-from the Macintosh.
-.LP
-Unix files beginning with `.' are not accessible from the mac.
-.LP
-If the
-.I pathname
-in an
-.B ~/AppleVolumes
-file does not exist, the volume will not be offered in the Chooser.
-.LP
-Microsoft Word
-.B TEXT
-documents do not get carriage return/line feed translation. This is
-because MS Word uses a type other than
-.B TEXT
-while writing the document, then changes the type to
-.BR TEXT .
-To allow users to edit their
-.BR ~/AppleVolumes ,
-.B afpd
-parses the files with either end of line character.
-.LP
-Unix filenames that are longer than 31 characters are inaccessible from
-the Macintosh.
-
+.TP
+\-I
+Use a platform specific icon. (Equivalent to \fB\-icon\fR
+in \fBafpd.conf\fR.)
+.TP
+\-f \fIdefaultvolumes\fR
+Specifies that \fIdefaultvolumes\fR
+should be read for a list of default volumes to offer, instead of
+\fB:ETCDIR:/AppleVolumes.default\fR.
+.TP
+\-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
+\-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
+\-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
+\-c \fImaxconnections\fR
+Specifies the maximum number of connections to allow for this
+afpd. The default is 20.
+.TP
+\-g \fIguest\fR
+Specifies the name of the guest account. The default is
+\fInobody\fR'.
+.TP
+\-P \fIpidfile\fR
+Specifies the file in which afpd stores its
+process id.
+.TP
+\-S \fIport\fR
+Specifies the port to register with when doing AFPoverTCP.
+Defaults to 548. (Equivalent to \fB\-port \fRin
+\fBafpd.conf\fR.)
+.TP
+\-L \fImessage\fR
+Specifies the login message that will be sent to clients.
+(Equivalent to \fB\-loginmsg\fR in \fBafpd.conf\fR.)
+.TP
+\-F \fIconfigfile\fR
+Specifies the configuration file to use. (Defaults to
+\fB:ETCDIR:/netatalk/afpd.conf\fR.)
+.TP
+\-U \fIuams\fR
+Comma\-separated list of UAMs to use for the authentication
+process. (Equivalent to \fB\-uamlist\fR in
+\fBafpd.conf\fR.)
+.TP
+\-m \fIumask\fR
+Use this umask for the creation of
+folders in Netatalk.
.SH SIGNALS
-Signals that are sent to the main
-.B afpd
-process are propagated to the children, so all will be affected.
-.TP 13
-.B SIGHUP
-The
-.B 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
-.BR afpd ,
-the other children are not affected. However, the main process will still
-exit, disabling all new connections.
-.TP 13
-.B SIGUSR1
-If the
-.B --with-message-dir
-configure option was used, the
-.B afpd
-process will set the
-.B debug
-option and redirect the messages to
-.RI /var/tmp/afpd-debug- pid .
-This should only be sent to a child
-.BR afpd .
-.B Warning:
-If the
-.B --with-message-dir
-option was not used, this will kill the
-.B afpd
-process.
-
-.TP 13
-.B SIGUSR2
-The
-.B afpd
-process will look in the
-.I msg
-directory for a file named
-.RI 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.
+Signals that are sent to the main afpd process
+are propagated to the children, so all will be affected.
+.TP
+SIGHUP
+Sending a SIGHUP to afpd will cause it to
+reload its configuration files.
+.TP
+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
+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 20
-.B :ETCDIR:/AppleVolumes.default
+.TP
+\fB:ETCDIR:/AppleVolumes.default\fR
list of default volumes to mount
-.TP 20
-.B :ETCDIR:/AppleVolumes.system
+.TP
+\fB:ETCDIR:/AppleVolumes.system\fR
list of volumes to offer all users
-.TP 20
-.B ~/AppleVolumes
+.TP
+\fB~/AppleVolumes\fR
user's list of volumes to mount
-.TP 20
-.BI :ETCDIR:/msg/message. pid
+.TP
+\fB:ETCDIR:/netatalk/msg/message.pid\fR
contains messages to be sent to users.
-.TP 20
-.BI /var/tmp/afpd-debug- pid
-contains debug output, if triggered.
.SH BUGS
-A few calls from the AFP specification are not implemented, because the
-Macintosh does not use them.
+.SH SEE\ ALSO
+\fBhosts_access\fR(5),
+\fBafpd.conf\fR(5),
+\fBAppleVolumes.default\fR(5),
+\fBAppleVolumes.system\fR(5).
+
-.TH ATALKD 8 "17 Nov 1995" "netatalk 1.3"
+.TH atalkd 8 17\ Nov\ 1995 "Netatalk 2.0-alpha1"
.SH NAME
atalkd \- AppleTalk RTMP, NBP, ZIP, and AEP manager
.SH SYNOPSIS
-.B :SBINDIR:/atalkd
-[
-.B -f
-.I configfile
-] [
-.B -1
-|
-.B -2
-]
+\fBatalkd\fR [\-f \fBconfigfile\fR] [\-1] [\-2]
.SH DESCRIPTION
-.B 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
-.BR ping (8)).
-.B atalkd
-is typically started at boot time, out of
-.B /etc/rc.
-It first reads from its configuration file,
-.BR :ETCDIR:/atalkd.conf .
-If there is no configuration file,
-.B 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
-.RB ` # '
-in the first column are ignored, as are blank lines. The syntax is
-.RS
-.sp
-.I interface
-[
-.B -seed
-] [
-.B -phase
-.I number
-] [
-.B -net
-.I net-range
-] [
-.B -addr
-.I address
-] [
-.B -zone
-.I zonename
-] ...
-.sp
-.RE
-Note that all field except the
-.I interface
-are optional. The loopback interface is configured automatically. If
-.B -seed
-is specified, all other fields must be present. Also,
-.B atalkd
-will exit during bootstrapping, if a router disagrees with its seed
-information. If
-.B -seed
-is not given, all other information may be overriden during
-auto-configuration. If no
-.B -phase
+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
+.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 ] ...
+.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
-.B -addr
-is given and
-.B -net
-is not, a
-.I net-range
-of one is assumed.
-.LP
-The first
-.B -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.
-.B 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.
-.BR afpd ,
-must individually specify the desired zone. See also
-.BR nbp_name (3).
+(the default is 2). If \fB\-addr\fR is given and
+\fB\-net\fR is not, a net\-range of one is assumed.
+.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.
-.LP
-.B atalkd
-can provide routing between interfaces by configuring multiple
-interfaces. Each interface must be assigned a unique
-.I 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
-.IR net-range ,
-i.e. if you have three machines on an Ethernet, don't chose a
-.I net-range
-of 1000-2000. Each
-.I net-range
-may have an arbitrary list of zones associated with it.
-.SH EXAMPLE
-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.
-.sp
-.RS
+.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.
+.PP
.nf
-le0
-le1 -seed -net 9461-9471 -zone netatalk -zone Argus
+ le0
+ le1 \-seed \-net 9461\-9471 \-zone netatalk \-zone Argus
.fi
-.RE
-.sp
-.B atalkd
+
+atalkd
automatically acts as a router if there is more than one interface.
.SH FILES
-.TP 30
-.B :ETCDIR:/atalkd.conf
-configuration file
+\fB:ETCDIR:/atalkd.conf\fR configuration file
.SH BUGS
On some systems, atalkd can not be restarted.
+
-.TH CNID_DBD 8 "2 Dez 2003" ":NETATALK_VERSION:"
-
+.TH cnid_dbd 8 2\ Dec\ 2003 "Netatalk 2.0-alpha1"
.SH NAME
-cnid_dbd \- implement access to CNID databases through a dedicated daemon process
+cnid_dbd \- implement access to CNID databases through a dedicated daemon process
.SH SYNOPSIS
-.B cnid_dbd
-.BI dbdir
+\fBcnid_dbd\fR \fBdbdir\fR \fBctrlfd\fR \fBclntfd\fR
.SH DESCRIPTION
-.B cnid_dbd
-provides an interface for storage and retrieval of catalog node IDs
-(CNIDs) and related information to the
-.BR afpd
-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.
-.B cnid_dbd
-is part of the
-.BR "CNID backend"
-framework of
-.BR afpd
-and implements the
-.B dbd
-backend.
-.LP
-.B cnid_dbd
-is never started via the command line or system startup scripts but only by the
-.BR cnid_metad
-daemon. There is at most one instance of
-.B cnid_dbd
-per netatalk volume.
-.LP
-.B cnid_dbd
-uses the
-.BR "Berkleley DB"
-database library and optionally supports
-transactionally protected updates if the netatalk package is compiled
-with the appropriate options. Using the
-.B dbd
-backend without transactions will protect the CNID database against unexpected crashes of the
-.BR afpd
-daemon.
-Using the
-.B dbd
-backend with transactions will avoid corruption of the CNID database even if the
-system crashes unexpectedly.
-.LP
-.B cnid_dbd
-uses the same on-disk database format as the
-.B cdb
-backend. It is therefore possible to switch between the two backends as necessary.
-.LP
-.B cnid_dbd
-inherits the effective userid and groupid from
-.BR cnid_metad
-on startup, which is normally caused by
-.BR afpd
-serving a netatalk volume to a client. It changes to the
-.BR "Berkleley DB"
-database home directory
-.I dbdir
-that is associated with the volume, opens the database
-and starts serving requests. Subsequent instances of
-.BR afpd
-that want to access the same volume are redirected to the running
-.B cnid_dbd
-by
-.BR cnid_metad.
-.LP
-.B cnid_dbd
-can be configured to run forever or to exit after a period of inactivity. If
-.B cnid_dbd
-receives a TERM or an INT signal it will exit cleanly after
-flushing dirty database buffers to disk and closing
-.BR "Berkleley DB"
-database environments. It is safe to terminate
-.B cnid_dbd
+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, opens the database and starts serving
+requests using the filedescriptor \fIclntfd\fR.
+Subsequent instances of \fIafpd\fR that
+want to access the same volume are redirected to the running
+cnid_dbd 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. Please see the sections
+\fIDatabase and log file archival\fR, \fI
+Log 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.
.SH CONFIGURATION
-.B cnid_dbd
-reads configuration information from the file
-.I db_param
-in the database directory
-.I dbdir
-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
-.BI cachesize
-Determines the size of the Berkeley DB cache in
-kilobytes. Default: 1024. Each
-.B cnid_dbd
-process grabs that much memory on top of its
-normal memory footprint. It can be used to tune database
-performance. The
-.BI db_stat
-utility with the
-.B "-m"
-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
+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
+\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
-.B "Berkeley DB Tutorial and Reference Guide"
-has a section
-.B "Selecting a cache size"
-that gives more detailed information.
-.TP
-.BI "nosync"
-This flag is only valid if 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
-.B "Transaction Throughput"
-in the Berkeley DB Tutorial for
-more information. Default: 0.
+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 only valid if 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
-.BI "flush_frequency"
-.TP
-.BI "flush_interval"
-.I "flush_frequency"
-(Default: 100)
-and
-.I "flush_interval"
-(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
-.I flush_frequency
-requests have been
-received or ii) more than
-.I flush_interval
-seconds have elapsed since
-the last save/checkpoint. If you use transactions with
-.I nosync
-set to
-zero these parameters only influence how long recovery takes after
-a crash, there should never be any lost data. If
-.I nosync
-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
-.BI fd_table_size
-is the maximum number of connections (filedescriptors)
-that can be open for
-.BI afpd
-client processes in
-.B cnid_dbd.
-Default: 16.
-If this number
-is exceeded, one of the existing connections is closed and reused. The
-affected
-.BI afpd
-process will transparently reconnect later, which causes
-slight overhead. On the other hand, setting this parameter too high
-could affect performance in
-.B cnid_dbd
-since all descriptors have to be
-checked in a
-.BI 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
-.BI afpd
-client process
-is expected to run, e.g. home directories.
-.TP
-.BI "idle_timeout"
+\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
is the number of seconds of inactivity before an idle
-.B cnid_dbd
-exits. Default: 600. Set this to 0 to disable the timeout.
-
-
-.SH SEE ALSO
-.BR cnid_metad (1),
-.BR afpd (8)
-
-
-
-
-
-
-
-
+cnid_dbd exits. Default: 600. Set this to 0 to
+disable the timeout.
+.SH SEE\ ALSO
+\fBcnid_metad\fR(1),
+\fBafpd\fR(8)
-.TH CNID_METAD 8 "28 Nov 2003" ":NETATALK_VERSION:"
-
+.TH cnid_metad 8 28\ Nov\ 2003 "Netatalk 2.0-alpha1"
.SH NAME
cnid_metad \- start cnid_dbd daemons on request
.SH SYNOPSIS
-.B cnid_metad
-[
-.B -d
-]
-[
-.B -h
-.I hostname
-]
-[
-.B -p
-.I port
-]
-[
-.B -u
-.I user
-]
-[
-.B -g
-.I group
-]
-[
-.B -s
-.I cnid_dbd pathname
-]
+\fBcnid_metad\fR [\-d] [ \-h \fBhostname\fR ] [ \-p \fBport\fR ] [ \-u \fBuser\fR ] [ \-g \fBgroup\fR ] [ \-s \fBcnid_dbdpathname\fR ]
.SH DESCRIPTION
-.B cnid_metad
-waits for requests from
-.BR afpd
-to start up instances of the
-.BR cnid_dbd
-daemon. It keeps track of the status of a
-.BR cnid_dbd
+cnid_metad waits for requests from \fIafpd\fR to start up instances of the \fIcnid_dbd\fR
+daemon. It keeps track of the status of a \fIcnid_dbd\fR
instance once started and will restart it if necessary.
-.B cnid_metad
-is normally started at boot time from
-.BR /etc/rc
-or equivalent and runs until shutdown.
-.BR afpd
-needs to be configured with the
-.B -cnidserver
-option in
-.BR afpd.conf
-in order to access
-.B cnid_metad.
-It is possible to run more than one instance of
-.B cnid_metad
-on the same machine if different values for the interface and/or port are specified with the
-.B -h
-and
-.B -p
-options.
-
-.SH OPTIONS
+cnid_metad is normally started at boot time from
+\fB/etc/rc\fR or equivalent and runs until shutdown.
+\fIafpd\fR needs to be configured with the
+\fB\-cnidserver\fR option in \fIafpd.conf\fR
+in order to access \fIcnid_metad.\fR It is
+possible to run more than one instance of cnid_metad on
+the same machine if different values for the interface and/or port are
+specified with the \fB\-h\fR and \fB\-p\fR options.
+.SH OPTIONS
.TP
-.B \-d
-.B cnid_metad will remain in the foreground and
-will also leave the standard input, standard output and standard error
-file descriptors open. Useful for debugging.
+\fB\-d\fR
+\fIcnid_metad will remain in the foreground
+and\fR will also leave the standard input, standard output
+and standard error file descriptors open. Useful for debugging.
.TP
-.BI \-h " hostname"
-Use
-.I hostname
-as the network interface for requests as opposed to
-the default
-.B "localhost".
+\fB\-h\fR\fI hostname\fR
+Use \fIhostname\fR as the network
+interface for requests as opposed to the default \fIlocalhost
+\fR.TP
+\fB\-p\fR\fI port\fR
+Use \fIport\fR as the port number for
+reqests. Default is 4700.
.TP
-.BI \-p " port"
-Use
-.I port
-as the
-port number for reqests. Default is 4700.
+\fB\-u\fR\fI user\fR
+Switch to the userid of \fIuser\fR
+before serving requests. This userid will be inherited by all
+\fIcnid_dbd\fR daemon processes started.
.TP
-.BI \-u " user"
-Switch to the userid of
-.I user
-before serving requests. This userid will be
-inherited by all
-.BR cnid_dbd
-daemon processes started.
+\fB\-u\fR\fI group\fR
+Switch to the groupid of \fIgroup\fR
+before serving requests. This groupid will be inherited by all
+\fIcnid_dbd\fR daemon processes started.
+Both \fIuser\fR and \fIgroup\fR
+must be specified as strings.
.TP
-.BI \-u " group"
-Switch to the groupid of
-.I group
-before serving requests. This groupid will be inherited by all
-.BR cnid_dbd
-daemon processes started. Both
-.I user
-and
-.I group
-must be specified as strings.
-.TP
-.BI \-s " cnid_dbd pathname"
-Use
-.I cnid_dbd pathname
-as the pathname
-of the executeable of the
-.BR cnid_dbd
-daemon. The default is
-.IR :SBINDIR:/cnid_dbd.
-.SH CAVEATS
-The number of
-.BR cnid_dbd
-subprocecesses is currently limited to 128. This restriction will be
-lifted in the future.
-.LP
-.B cnid_metad
-does not block or catch any signals apart from SIGPIPE. It will
-therefore exit on most signals received. This will also cause all instances of
-.BR cnid_dbd's
-started by that
-.B cnid_metad
-to exit gracefully.
-Since state about and IPC access to the
-subprocesses is only maintained in memory by
-.B cnid_metad
-this is desired behaviour. As soon as
-.B cnid_metad
-is restarted
-.BR afpd
+\fB\-s\fR\fI cnid_dbd pathname\fR
+Use \fIcnid_dbd pathname\fR as the
+pathname of the executeable of the \fIcnid_dbd\fR
+daemon. The default is \fI:SBINDIR:/cnid_dbd.\fR
+.SH CAVEATS
+The number of \fIcnid_dbd\fR subprocecesses
+is currently limited to 128. This restriction will be lifted in the
+future.
+.PP
+cnid_metad does not block or catch any signals
+apart from SIGPIPE. It will therefore exit on most signals received. This
+will also cause all instances of \fIcnid_dbd's\fR
+started by that cnid_metad to exit gracefully. Since
+state about and IPC access to the subprocesses is only maintained in
+memory by cnid_metad this is desired behaviour. As soon
+as cnid_metad is restarted \fIafpd\fR
processes will transparently reconnect.
-
-.SH SEE ALSO
-.BR cnid_dbd (1),
-.BR afpd (8)
-
-
-
-
-
+.SH SEE\ ALSO
+\fBcnid_dbd\fR(1),
+\fBafpd\fR(8)
-'\" t
-.TH PAPD 8 "06 Mar 2001" "netatalk 1.5"
+.\" t
+.TH papd 8 06\ January\ 2004 "Netatalk 2.0-alpha1"
.SH NAME
papd \- AppleTalk print server daemon
.SH SYNOPSIS
-.B :SBINDIR:/papd
-[
-.B -d
-] [
-.B -f
-.I configfile
-] [
-.B -p
-.I printcap
-]
+\fBpapd\fR [\-d] [\-f configfile] [\-p printcap]
.SH DESCRIPTION
-.B papd
-is the AppleTalk printer daemon. This daemon accepts print jobs from
-AppleTalk clients (typically Macintosh computers) using the Printer
-Access Protocol (PAP).
-.B papd
-spools jobs directly into an
-.BR lpd (8)
-spool directory and wakes up
-.B 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
-.B lpd.
-.B papd
-can also pipe the print job to an external program for processing, and
-this is the preferred method to avoid compatibility problems with all
-the flavors of lpd in use.
-.LP
-.B papd
-is typically started at boot time, out of system init scripts.
-It first reads from its configuration file,
-.BR :ETCDIR:/papd.conf .
-The file is in the same format as
-.BR /etc/printcap .
-See
-.BR printcap (5)
-for details. The name of the entry is registered with
-.BR NBP .
-The following options are supported:
-.LP
+papd is the AppleTalk printer daemon. This daemon
+accepts print jobs from AppleTalk clients (typically Macintosh computers)
+using the Printer Access Protocol (PAP). 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. papd can also pipe the print
+job to an external program for processing, and this is the preferred
+method to avoid compatibility problems with all the flavors of
+lpd in use.
+.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:
.TS
-c c l l
-cfB l l l .
-Name Type Default Descripton
-.sp .5
-pd str `.ppd' Pathname to PPD file
-pr str `lp' LPD printer name (or print command)
-op str `operator' Operator name for LPD spooling
-ca str NULL Pathname used for CAP-style authentication
-sp bool false PSSP-style authentication
-am str NULL UAMS to use for authentication
-pa str NULL Printer's AppleTalk address?
+c c c l.
+T{
+Name
+T} T{
+Type
+T} T{
+Default
+T} T{
+Description
+T}
+.T&
+c l l l.
+T{
+pd
+T} T{
+str
+T} T{
+\&'.ppd'
+T} T{
+Pathname
+to PPD file
+T}
+T{
+pr
+T} T{
+str
+T} T{
+\&'lp'
+T} T{
+LPD
+printer name (or print command)
+T}
+T{
+op
+T} T{
+str
+T} T{
+\&'operator'
+T} T{
+Operator
+name for LPD spooling
+T}
+T{
+ca
+T} T{
+str
+T} T{
+NULL
+T} T{
+Pathname
+used for CAP\-style authentification
+T}
+T{
+sp
+T} T{
+bool
+T} T{
+false
+T} T{
+PSSP\-style
+authetication
+T}
+T{
+am
+T} T{
+str
+T} T{
+NULL
+T} T{
+UAMS
+to use for authentication
+T}
+T{
+pa
+T} T{
+str
+T} T{
+NULL
+T} T{
+Printer's
+AppleTalk address
+T}
.TE
-.LP
-If no configuration file is given, the hostname of the machine is used
-as the NBP name and all options take their default value.
+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
-.B -d
-Do not fork or disassociate from the terminal. Write some
+.TP
+\-d
+Do not fork or disassociate from the terminal. Write some
debugging information to stderr.
-.HP
-.B -f
-.I configfile
-.br
-Consult
-.I configfile
-instead of
-.B :ETCDIR:/papd.conf
-for the configuration information.
-.HP
-.B -p
-.I printcap
-.br
-Consult
-.I printcap
-instead of
-.B /etc/printcap
-for LPD configuration information.
-.SH EXAMPLE
+.TP
+\-f \fIconfigfile\fR
+Consult \fIconfigfile\fR instead of
+\fB:ETCDIR:/papd.conf\fR for the configuration
+information.
+.TP
+\-p \fIprintcap\fR
+Consult \fIprintcap\fR instead of
+\fB/etc/printcap\fR for LPD configuration
+information.
+.SH EXAMPLES
The following papd configuration file sets up three print spoolers.
-The first spooler is known by the NBP name
-.B 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
-.B HP Printer
-and all options are the default. The third spooler is known as
-.B HP 8100 .
-It pipes the print job to lpr for printing. PSSP authenticated printing
-is enabled, as is CAP-style authenticated printing. Both methods support
-guest and cleartext authentication as specified by the 'am' option. The
-PPD used is /etc/atalk/ppds/hp8100.ppd.
-.sp
-.RS
+The first spooler is known by the NBP 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. The third
+spooler is known as HP 8100. It pipes the print job to lpr 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
+\fB/etc/atalk/ppds/hp8100.ppd\fR.
+
.nf
-Mac Printer Spooler:\\
- :pr=ps:\\
- :pd=/usr/share/lib/ppd/HPLJ_4M.PPD:\\
- :op=mcs:
+Mac Printer Spooler:\\
+ :pr=ps:\\
+ :pd=/usr/share/lib/ppd/HPLJ_4M.PPD:\\
+ :op=mcs:
-HP Printer:\\
- :
+HP Printer:\\
+ :
HP 8100:\\
- :pr=|/usr/bin/lpr -Plp:\\
- :sp:\\
- :ca=/tmp/print:\\
- :am=uams_guest.so,uams_pam.so:\\
- :pd=/etc/atalk/ppds/hp8100.ppd:
+ :pr=|/usr/bin/lpr \-Plp:\\
+ :sp:\\
+ :ca=/tmp/print:\\
+ :am=uams_guest.so,uams_pam.so:\\
+ :pd=/etc/atalk/ppds/hp8100.ppd:
.fi
-.RE
.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
+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
+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
-that CAP-style authentication, described below.
-.LP
-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.
-.B afpd
-records the username in a temporary file named after the clients
-Appletalk address, and it deletes the temporary file when the user
-disconnects.
-.B 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 it will fall back to PSSP.
-.LP
-
-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, uams_passwd.so, and uams_pam.so are supported as printer
-authentication methods. The guest method requires a valid username, but
-not a password. The passwd and pam methods require both a valid username
-and the correct password.
+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 that
+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 clients Appletalk address, and it deletes the
+temporary file when the user disconnects. Therefore CAP style
+authentification will \fInot\fR work for clients connecting
+over 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 it 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, uams_passwd.so, and uams_pam.so are supported as
+printer authentication methods. The guest method requires a valid
+username, but not a password. The passwd and pam methods require both a
+valid username and the correct password.
+.RS
+\fBNote\fR
+.PP
+The OSX printing system doesn't seem to support
+authentification anymore.
+.RE
+.PP
.SH FILES
-.TP 16
-.B :ETCDIR:/papd.conf
+.TP
+\fB:ETCDIR:/papd.conf\fR
Default configuration file.
-.TP 16
-.B /etc/printcap
+.TP
+\fB/etc/printcap\fR
Printer capabilities database.
-.TP 16
-.B .ppd
-PostScript Printer Description file.
-.B papd
-answers configuration and font queries from printing clients by
-consulting the configured PPD file. Such files are available from
-Adobe, Inc, via anonymous ftp from ftp.adobe.com in /pub/adobe/printerdrivers/mac/all/ppdfiles/
-(ftp://ftp.adobe.com//pub/adobe/printerdrivers/mac/all/ppdfiles/), or from the printer's
-manufacturer. If no PPD file is configured,
-.B papd
-will return the default answer, possibly causing the client to send
-excessively large jobs.
-.SH SEE ALSO
-.BR lpr (1),
-.BR lprm (1),
-\." .BR pap (4),
-.BR printcap (5).
-.BR lpc (8),
-.BR lpd (8).
+.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
-.I 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. You will
-need to configure your printer to accept a full 8 bits.
+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. You will need to configure your printer
+to accept a full 8 bits.
+.SH SEE\ ALSO
+\fBlpr\fR(1),\fBlprm\fR(1),\fBprintcap\fR(5),\fBlpc\fR(8),\fBlpd\fR(8).
+
-.TH PAPSTATUS 8 "17 Dec 1991"
+.TH papstatus 8 17\ Dec\ 1991 "Netatalk 2.0-alpha1"
.SH NAME
-papstatus \- get the status of an AppleTalk-connected printer
+papstatus \- get the status of an AppleTalk\-connected printer
.SH SYNOPSIS
-.B :SBINDIR:/papstatus
-[
-.BI -d
-] [
-.B -p
-.I printer
-] [
-.I retrytime
-]
+\fB:SBINDIR:/papstatus\fR [\-d] [ \-p \fBprinter\fR ] [\fBretrytime\fR]
.SH DESCRIPTION
-.B papstatus
-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.
-.LP
-If no printer is specified on the command line,
-.B papstatus
-looks for a file called
-.B .paprc
-in the current directory and reads it to obtain the name of a printer. The
-.B .paprc
-file should contain a single line of the form
-.IB object : \c
-.IB type @ \c
-.I zone
-where each of
-.IR object ,
-.BI : type ,
-and
-.BI @ zone
-are optional.
-.I type
-and
-.I zone
-must be proceeded by
-.RB ` : '
-and
-.RB ` @ '
-respectively. Blank lines and lines the begin with a
-.RB ` # '
-are ignored.
-.I type
-and
-.I zone
-default to
-.B LaserWriter
-and the zone of the local host, respectively.
+\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.
+.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
-.B -d
-Turns on a debugging mode that prints some extra information to standard error.
-.HP
-.B -p
-.I printer
-.br
-Get status from
-.I printer
-(do not consult any
-.B .paprc
-files to find a printer name). The syntax for
-.I printer
-is the same as discussed above for the
-.B .paprc
-file.
-.TP
-.I retrytime
-Normally,
-.B papstatus
-only gets the status from the printer once. If
-.I retrytime
+.TP
+\fB\-d\fR
+Turns on a debugging mode that prints some extra information
+to standard error.
+.TP
+\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
+\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
-.I retrytime
-seconds between inquiring the printer.
+\fIretrytime\fR seconds between inquiring
+the printer.
.SH FILES
-.TP 20
-.B .paprc
+.TP
+\&.paprc
file that contains printer name
-.SH SEE ALSO
-.BR nbp (1),
-.BR pap (8)
+.SH SEE\ ALSO
+\fBnbp\fR(1),
+\fBpap\fR(8)
+
-.TH PSF 8 "17 Dec 1991" "netatalk 1.2"
+.TH psf 8 17\ Dec\ 1991 "Netatalk 2.0-alpha1"
.SH NAME
psf \- PostScript filter
.SH SYNOPSIS
-.B psf
-[
-.B -n
-.I name
-] [
-.B -h
-.I host
-] [
-.B -w
-.I width
-] [
-.B -l
-.I length
-] [
-.B -i
-.I indent
-] [
-.B -c
-]
+\fBpsf\fR [ \-n \fBname\fR ] [ \-h \fBhost\fR ] [ \-w \fBwidth\fR ] [ \-l \fBlength\fR ] [ \-i \fBindent\fR ] [\-c]
.SH DESCRIPTION
-.B psf
-is an
-.B lpd
-filter for PostScript printing.
-.B psf
-interprets the name it was called with to determine what filters to
-invoke. First, if the string ``pap'' appears anywhere in the name,
-.B psf
-invokes
-.B pap
-to talk to a printer via AppleTalk. Next, if the string ``rev'' appears,
-.B psf
-invokes
-.B psorder
-to reverse the pages of the job. Finally, if
-.B psf
-was called with a filter's name as the leading string, it invokes that
-filter. If there is no filter to run,
-.B psf
-examines the magic number of the input, and if the input is not
-PostScript, converts it to PostScript.
+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,
-.B psf
-supports two kludges. The first causes
-.B psf
-to check its name for the letter `m'. If this letter is found and accounting
-is turned on,
-.B psf
-calls
-.B pap
-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.
-.LP
-The second kludge causes
-.B psf
-to examine its name for the letter `w'. If this letter is found and
-accounting is turned on,
-.B psf
-calls
-.B pap
-with the
-.B \-w
-flag. This flag causes
-.B pap
-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
+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.
+.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
-.B printcap
-entry below invokes
-.B psf
-to print text files, PostScript files,
-.BR troff 's
-C/A/T output, and
-.BR TeX '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
-.RS
+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.
+.PP
.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:\\
+ :lf=/var/adm/lpd\-errs:pw#80:hl:\\
:of=:LIBEXECDIR:/ofpap:\\
:if=:LIBEXECDIR:/ifpaprev:\\
:tf=:LIBEXECDIR:/tfpaprev:\\
:df=:LIBEXECDIR:/dfpaprev:
.fi
-.RE
-.sp
+.PP
Note that if the host in question spools to more than one AppleTalk
-printer,
-.B /dev/null
-should not be used for the
-.B lp
-capability. Instead, a null device should be created with
-.B mknod
-for each printer, as has been done above.
-.LP
+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.
+.PP
Finally, there is a file in the spool directory,
-.BR /var/spool/lpd/laser ,
-called
-.BR .paprc ,
-which
-.B pap
-reads for the AppleTalk name of the printer.
-.SH SEE ALSO
-.BR psorder (1),
-.BR printcap (5),
-.BR lpd (8),
-.BR mknod (8),
-.BR pap (8).
+\fB/var/spool/lpd/laser\fR, called .paprc,
+which \fIpap\fR reads for the AppleTalk name of
+the printer.
+.SH SEE\ ALSO
+\fBpsorder\fR(1),
+\fBprintcap\fR(5),
+\fBlpd\fR(8),
+\fBmknod\fR(8),
+\fBpap\fR(8).
+
-.TH "timelord" "8" "27 Jun 2001" "netatalk 1.5pre7" "The Netatalk Project"
-.SH "NAME"
-.LP
+.TH timelord 8 27\ Jun\ 2001 "Netatalk 2.0-alpha1"The\ Netatalk\ Project
+.SH NAME
timelord \- Macintosh time server daemon
-.SH "SYNTAX"
-.LP
-timelord [\-d] [\-n \fIfilename\fP]
-.SH "DESCRIPTION"
-.LP
-\fBtimelord\fR is a simple time server for Macintosh
-computers that use the \fBtardis\fR client.
-.SH "OPTIONS"
-.LP
+.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
\fB\-d\fR
Debug mode, i.e. don't disassociate from controlling TTY.
.TP
-\fB\-n\fR \fInbpname\fP
-Register this server as \fInbpname\fP. This defaults to
-the hostname.
+\fB\-n\fR \fInbpname\fR
+Register this server as \fInbpname\fR.
+This defaults to the hostname.
+
projects / netatalk.git / commitdiff