-# Makefile.am for config/
+## Makefile.am for config/
+
+SUFFIXES = .tmpl .
+
+.tmpl:
+ sed -e s@:UAMS_PATH:@${UAMS_PATH}@ \
+ -e s@:NLS_PATH:@${CONFIG_DIR}/nls@ \
+ -e s@:ETCDIR:@${CONFIG_DIR}@ \
+ <$^ >$@
+
+CLEANFILES = afpd.conf
configdir = $(CONFIG_DIR)
+++ /dev/null
-#
-# CONFIGURATION FOR AFPD
-#
-# Each line defines a virtual server that should be available.
-# Empty lines and lines beginning with `#' are ignored.
-# Options in this file will override both compiled-in defaults
-# and command line options.
-#
-# Format:
-# - [options] to specify options for the default server
-# "Server name" [options] to specify an additional server
-#
-# The following options are available:
-# Transport Protocols:
-# -[no]tcp Make AFP-over-TCP [not] available
-# -[no]ddp Make AFP over AppleTalk [not] available. if you
-# have -proxy specified, specify -uamlist "" to
-# prevent ddp connections from working.
-#
-# -transall Make both available (default)
-#
-# Transport Options:
-# -ipaddr <w.x.y.z> Specifies the IP address the server should respond
-# to (default is the first IP address of the system)
-# This option also allows one machine to advertise
-# TCP/IP for another machine.
-# -server_quantum <number>
-# Specifies the DSI server quantum. The minimum
-# value is 1MB. The max value is 0xFFFFFFFF. If you
-# specify a value that is out of range, you'll get
-# the default value (currently the minimum).
-# -admingroup <groupname>
-# Specifies the group of administrators who should all
-# be seen as the superuser when they log in. Default
-# is disabled.
-# -ddpaddr x.y Specifies the DDP address of the server. the
-# default is to auto-assign an address
-# (0.0). this is only useful if you're running
-# on a multihomed host.
-# -port <number> Specifies the TCP port the server should respond
-# to (default is 548)
-# -fqdn <name:port> specify a fully-qualified domain name (+
-# optional port). this gets discarded if the
-# server can't resolve it. this is not honored
-# by appleshare clients <= 3.8.3 (default: none)
-# -proxy Run an AppleTalk proxy server for specified AFP/TCP
-# server (if address/port aren't given, then
-# first IP address of the system/548 will be used).
-# if you don't want the proxy server to act as
-# a ddp server as well, set -uamlist to an
-# empty string.
-#
-#
-# Authentication Methods:
-# -uampath <path> Use this path to look for User Authentication Modules.
-# (default: :RESDIR:/uams)
-# -uamlist <a,b,c> Comma-separated list of UAMs. (default:
-# uams_guest.so,uams_clrtxt.so,uams_dhx.so)
-#
-# some commonly available UAMs:
-# uams_guest.so: Allow guest logins
-#
-# uams_clrtxt.so: (uams_pam.so or uams_passwd.so)
-# Allow logins with passwords
-# transmitted in the clear.
-#
-# uams_randnum.so: Allow Random Number and Two-Way
-# Random Number exchange for
-# authentication.
-#
-# uams_dhx.so: (uams_dhx_pam.so or uams_dhx_passwd.so)
-# Allow Diffie-Hellman eXchange
-# (DHX) for authentication.
-#
-# Password Options:
-# -[no]savepassword [Don't] Allow clients to save password locally
-# -passwdfile <path> Use this path to store Randnum
-# passwords. (default: ~/.passwd. the only other
-# userful value is :RESDIR:/etc/afppasswd.)
-# -passwdminlen <#> minimum password length. may be ignored.
-# -[no]setpassword [Don't] Allow clients to change their passwords.
-# -loginmaxfail <#> maximum number of failed logins. this may be
-# ignored if the uam can't handle it.
-#
-# AppleVolumes files:
-# -defaultvol <path> Specifies path to AppleVolumes.default file
-# (default :ETCDIR:/AppleVolumes.default,
-# same as -f on command line)
-# -systemvol <path> Specifies path to AppleVolumes.system file
-# (default :ETCDIR:/AppleVolumes.system,
-# same as -s on command line)
-# -[no]uservolfirst [Don't] read the user's ~/AppleVolumes or
-# ~/.AppleVolumes before reading
-# :ETCDIR:/AppleVolumes.default
-# (same as -u on command line)
-# -[no]uservol [Don't] Read the user's volume file
-#
-# -nlspath <path> Prepend this path to each code page filename
-# in volume options (default: :RESDIR:/nls).
-#
-# Miscellaneous:
-# -guestname "user" Specifies the user name for the guest login
-# (default "nobody", same as -g on command line)
-# -loginmesg "Message" Client will display "Message" upon logging in
-# (no default, same as -l "Message" on commandline)
-# -nodebug Switch off debugging
-# -tickleval <number> Specify the tickle timeout interval (in seconds)
-# -icon Use the platform-specific icon.
-#
-# Some examples:
-#
-# The simplest case is to not have an afpd.conf.
-#
-# 4 servers w/ names server1-3 and one w/ the hostname. servers
-# 1-3 get routed to different ports with server 3 being bound
-# specifically to address 192.168.1.3
-# -
-# server1 -port 12000
-# server2 -port 12001
-# server3 -port 12002 -ipaddr 192.168.1.3
-#
-# a dedicated guest server, a user server, and a special
-# ddp-only server:
-# "Guest Volume" -uamlist uams_guest.so -loginmesg "Welcome guest!"
-# "User Volume" -uamlist uams_clrtxt.so -port 12000
-# "special" -notcp -defaultvol <path> -systemvol <path>
-#
-# default:
-# - -transall -uamlist uams_guest.so,uams_clrtxt.so,uams_dhx.so -nosavepassword
--- /dev/null
+#
+# CONFIGURATION FOR AFPD
+#
+# Each line defines a virtual server that should be available.
+# Empty lines and lines beginning with `#' are ignored.
+# Options in this file will override both compiled-in defaults
+# and command line options.
+#
+# Format:
+# - [options] to specify options for the default server
+# "Server name" [options] to specify an additional server
+#
+# The following options are available:
+# Transport Protocols:
+# -[no]tcp Make AFP-over-TCP [not] available
+# -[no]ddp Make AFP over AppleTalk [not] available. if you
+# have -proxy specified, specify -uamlist "" to
+# prevent ddp connections from working.
+#
+# -transall Make both available (default)
+#
+# Transport Options:
+# -ipaddr <w.x.y.z> Specifies the IP address the server should respond
+# to (default is the first IP address of the system)
+# This option also allows one machine to advertise
+# TCP/IP for another machine.
+# -server_quantum <number>
+# Specifies the DSI server quantum. The minimum
+# value is 1MB. The max value is 0xFFFFFFFF. If you
+# specify a value that is out of range, you'll get
+# the default value (currently the minimum).
+# -admingroup <groupname>
+# Specifies the group of administrators who should all
+# be seen as the superuser when they log in. Default
+# is disabled.
+# -ddpaddr x.y Specifies the DDP address of the server. the
+# default is to auto-assign an address
+# (0.0). this is only useful if you're running
+# on a multihomed host.
+# -port <number> Specifies the TCP port the server should respond
+# to (default is 548)
+# -fqdn <name:port> specify a fully-qualified domain name (+
+# optional port). this gets discarded if the
+# server can't resolve it. this is not honored
+# by appleshare clients <= 3.8.3 (default: none)
+# -proxy Run an AppleTalk proxy server for specified AFP/TCP
+# server (if address/port aren't given, then
+# first IP address of the system/548 will be used).
+# if you don't want the proxy server to act as
+# a ddp server as well, set -uamlist to an
+# empty string.
+#
+#
+# Authentication Methods:
+# -uampath <path> Use this path to look for User Authentication Modules.
+# (default: :UAMS_PATH:)
+# -uamlist <a,b,c> Comma-separated list of UAMs. (default:
+# uams_guest.so,uams_clrtxt.so,uams_dhx.so)
+#
+# some commonly available UAMs:
+# uams_guest.so: Allow guest logins
+#
+# uams_clrtxt.so: (uams_pam.so or uams_passwd.so)
+# Allow logins with passwords
+# transmitted in the clear.
+#
+# uams_randnum.so: Allow Random Number and Two-Way
+# Random Number exchange for
+# authentication.
+#
+# uams_dhx.so: (uams_dhx_pam.so or uams_dhx_passwd.so)
+# Allow Diffie-Hellman eXchange
+# (DHX) for authentication.
+#
+# Password Options:
+# -[no]savepassword [Don't] Allow clients to save password locally
+# -passwdfile <path> Use this path to store Randnum
+# passwords. (default: ~/.passwd. the only other
+# userful value is :ETCDIR:/afppasswd.)
+# -passwdminlen <#> minimum password length. may be ignored.
+# -[no]setpassword [Don't] Allow clients to change their passwords.
+# -loginmaxfail <#> maximum number of failed logins. this may be
+# ignored if the uam can't handle it.
+#
+# AppleVolumes files:
+# -defaultvol <path> Specifies path to AppleVolumes.default file
+# (default :ETCDIR:/AppleVolumes.default,
+# same as -f on command line)
+# -systemvol <path> Specifies path to AppleVolumes.system file
+# (default :ETCDIR:/AppleVolumes.system,
+# same as -s on command line)
+# -[no]uservolfirst [Don't] read the user's ~/AppleVolumes or
+# ~/.AppleVolumes before reading
+# :ETCDIR:/AppleVolumes.default
+# (same as -u on command line)
+# -[no]uservol [Don't] Read the user's volume file
+#
+# -nlspath <path> Prepend this path to each code page filename
+# in volume options (default: :NLS_PATH:).
+#
+# Miscellaneous:
+# -guestname "user" Specifies the user name for the guest login
+# (default "nobody", same as -g on command line)
+# -loginmesg "Message" Client will display "Message" upon logging in
+# (no default, same as -l "Message" on commandline)
+# -nodebug Switch off debugging
+# -tickleval <number> Specify the tickle timeout interval (in seconds)
+# -icon Use the platform-specific icon.
+#
+# Some examples:
+#
+# The simplest case is to not have an afpd.conf.
+#
+# 4 servers w/ names server1-3 and one w/ the hostname. servers
+# 1-3 get routed to different ports with server 3 being bound
+# specifically to address 192.168.1.3
+# -
+# server1 -port 12000
+# server2 -port 12001
+# server3 -port 12002 -ipaddr 192.168.1.3
+#
+# a dedicated guest server, a user server, and a special
+# ddp-only server:
+# "Guest Volume" -uamlist uams_guest.so -loginmesg "Welcome guest!"
+# "User Volume" -uamlist uams_clrtxt.so -port 12000
+# "special" -notcp -defaultvol <path> -systemvol <path>
+#
+# default:
+# - -transall -uamlist uams_guest.so,uams_clrtxt.so,uams_dhx.so -nosavepassword
distrib/config/Makefile
distrib/config/netatalk-config
distrib/initscripts/Makefile
- distrib/initscripts/rc.atalk.redhat
distrib/m4/Makefile
etc/Makefile
etc/afpd/Makefile
-# Makefile for distrib/initscripts/
+## Makefile for distrib/initscripts/
+
+SUFFIXES = .tmpl .
+
+.tmpl:
+ sed -e s@:BINDIR:@${bindir}@ \
+ -e s@:SBINDIR:@${sbindir}@ \
+ -e s@:ETCDIR:@${CONFIG_DIR}@ \
+ <$^ >$@
sysvdir = /etc/rc.d/init.d/
sysv_SCRIPTS = rc.atalk.redhat
+
+CLEANFILES = rc.atalk.redhat
+
+++ /dev/null
-#! /bin/sh
-# chkconfig: 345 91 35
-# description: This package enables Linux to talk to Macintosh
-# computers via the AppleTalk networking protocol and
-# provides printer, file sharing, and AppleTalk routing
-# services.
-#
-# AppleTalk daemons. Make sure not to start atalkd in the background:
-# its data structures must have time to stablize before running the
-# other processes.
-
-# Source function library.
-. /etc/rc.d/init.d/functions
-
-# Source networking configuration.
-. /etc/sysconfig/network
-
-test -x :SBINDIR:/atalkd || exit 0
-
-test -f :ETCDIR:/netatalk.conf || exit 0
-
-# read in netatalk configuration
-. :ETCDIR:/netatalk.conf
-
-# Check that networking is up.
-[ ${NETWORKING} = "no" ] && exit 0
-
-# initialize return values
-RETVAL=1
-RETVAL_ATALKD=0
-RETVAL_PAPD=0
-RETVAL_AFPD=0
-
-# startup code for everything
-atalk_startup() {
- if [ x"${ATALKD_RUN}" != x"no" ]; then
- daemon :SBINDIR:/atalkd
- RETVAL_ATALKD=$?
-
- if [ -x :BINDIR:/nbprgstr ]; then
- :BINDIR:/nbprgstr -p 4 "${ATALK_NAME}:Workstation${ATALK_ZONE}"
- :BINDIR:/nbprgstr -p 4 "${ATALK_NAME}:netatalk${ATALK_ZONE}"
- fi
-
- if [ x"${PAPD_RUN}" = x"yes" -a -x :SBINDIR:/papd ]; then
- daemon :SBINDIR:/papd
- RETVAL_PAPD=$?
- fi
-
- if [ -x :SBINDIR:/timelord ]; then
- daemon :SBINDIR:/timelord
- fi
-
- fi
-
- if [ x"${AFPD_RUN}" = x"yes" -a -x :SBINDIR:/afpd ] ; then
- daemon :SBINDIR:/afpd ${AFPD_UAMLIST} -g ${AFPD_GUEST} \
- -c ${AFPD_MAX_CLIENTS} -n "${ATALK_NAME}${ATALK_ZONE}"
- RETVAL_AFPD=$?
- fi
-
- if [ $RETVAL_ATALKD -eq 0 -a $RETVAL_PAPD -eq 0 -a $RETVAL_AFPD -eq 0 ]; then
- RETVAL=0
- touch /var/lock/subsys/atalk || RETVAL=1
- fi
-}
-
-case "$1" in
-'start')
- echo -n 'Starting AppleTalk services: '
- if [ x"${ATALK_BGROUND}" = x"yes" ]; then
- echo -n "(backgrounded)"
- atalk_startup >& /dev/null &
- else
- atalk_startup
- fi
- echo
- ;;
-'stop')
- echo -n 'Shutting down AppleTalk services: '
- if [ x"${ATALKD_RUN}" != x"no" ]; then
- if [ x"${PAPD_RUN}" = x"yes" -a -x :SBINDIR:/papd ]; then
- killproc papd
- RETVAL_PAPD=$?
- fi
-
- if [ -x :SBINDIR:/timelord ]; then
- killproc timelord
- fi
-
- :BINDIR:/nbpunrgstr "${ATALK_NAME}:Workstation${ATALK_ZONE}"
- :BINDIR:/nbpunrgstr "${ATALK_NAME}:netatalk${ATALK_ZONE}"
-
- # kill atalkd last, since without it the plumbing goes away.
- if [ -x :SBINDIR:/atalkd ]; then
- killproc atalkd
- RETVAL_ATALKD=$?
- fi
- fi
-
- # kill this separately as we also do AFP/tcp
- if [ x"${AFPD_RUN}" = x"yes" -a -x :SBINDIR:/afpd ]; then
- killproc afpd
- RETVAL_AFPD=$?
- fi
-
- if [ $RETVAL_ATALKD -eq 0 -a $RETVAL_PAPD -eq 0 -a $RETVAL_AFPD -eq 0 ] ; then
- RETVAL=0
- rm -f /var/lock/subsys/atalk || RETVAL=1
- fi
- echo ""
- ;;
- 'restart'|'reload')
- $0 stop
- $0 start
- RETVAL=$?
- ;;
- 'status')
- status atalkd
- RETVAL=$?
- ;;
- *)
- echo "Usage: atalk {start|stop|restart|status}"
- exit 1
-esac
-
-exit $RETVAL
+++ /dev/null
-#! /bin/sh
-# chkconfig: 345 91 35
-# description: This package enables Linux to talk to Macintosh
-# computers via the AppleTalk networking protocol and
-# provides printer, file sharing, and AppleTalk routing
-# services.
-#
-# AppleTalk daemons. Make sure not to start atalkd in the background:
-# its data structures must have time to stablize before running the
-# other processes.
-
-# Source function library.
-. /etc/rc.d/init.d/functions
-
-# Source networking configuration.
-. /etc/sysconfig/network
-
-test -x @prefix@/sbin/atalkd || exit 0
-
-test -f @CONFIG_DIR@/netatalk.conf || exit 0
-
-# read in netatalk configuration
-. @CONFIG_DIR@/netatalk.conf
-
-# Check that networking is up.
-[ ${NETWORKING} = "no" ] && exit 0
-
-# initialize return values
-RETVAL=1
-RETVAL_ATALKD=0
-RETVAL_PAPD=0
-RETVAL_AFPD=0
-
-# startup code for everything
-atalk_startup() {
- if [ x"${ATALKD_RUN}" != x"no" ]; then
- daemon @prefix@/sbin/atalkd
- RETVAL_ATALKD=$?
-
- if [ -x @prefix@/bin/nbprgstr ]; then
- @prefix@/bin/nbprgstr -p 4 "${ATALK_NAME}:Workstation${ATALK_ZONE}"
- @prefix@/bin/nbprgstr -p 4 "${ATALK_NAME}:netatalk${ATALK_ZONE}"
- fi
-
- if [ x"${PAPD_RUN}" = x"yes" -a -x @prefix@/sbin/papd ]; then
- daemon @prefix@/sbin/papd
- RETVAL_PAPD=$?
- fi
-
- # check for timelord in bin directory
- if [ -x @prefix@/bin/timelord ]; then
- daemon @prefix@/bin/timelord
- fi
-
- # check for timelord in sbin directory
- if [ -x @prefix@/sbin/timelord ]; then
- daemon @prefix@/sbin/timelord
- fi
-
- fi
-
- if [ x"${AFPD_RUN}" = x"yes" -a -x @prefix@/sbin/afpd ] ; then
- daemon @prefix@/sbin/afpd ${AFPD_UAMLIST} -g ${AFPD_GUEST} \
- -c ${AFPD_MAX_CLIENTS} -n "${ATALK_NAME}${ATALK_ZONE}"
- RETVAL_AFPD=$?
- fi
-
- if [ $RETVAL_ATALKD -eq 0 -a $RETVAL_PAPD -eq 0 -a $RETVAL_AFPD -eq 0 ]; then
- RETVAL=0
- touch /var/lock/subsys/atalk || RETVAL=1
- fi
-}
-
-case "$1" in
-'start')
- echo -n 'Starting AppleTalk services: '
- if [ x"${ATALK_BGROUND}" = x"yes" ]; then
- echo -n "(backgrounded)"
- atalk_startup >& /dev/null &
- else
- atalk_startup
- fi
- echo
- ;;
-'stop')
- echo -n 'Shutting down AppleTalk services: '
- if [ x"${ATALKD_RUN}" != x"no" ]; then
- if [ x"${PAPD_RUN}" = x"yes" -a -x @prefix@/sbin/papd ]; then
- killproc papd
- RETVAL_PAPD=$?
- fi
-
- # checking for timelord in bin directory
- if [ -x @prefix@/bin/timelord ]; then
- killproc timelord
- fi
-
- # checking for timelord in sbin directory
- if [ -x @prefix@/sbin/timelord ]; then
- killproc timelord
- fi
-
- @prefix@/bin/nbpunrgstr "${ATALK_NAME}:Workstation${ATALK_ZONE}"
- @prefix@/bin/nbpunrgstr "${ATALK_NAME}:netatalk${ATALK_ZONE}"
-
- # kill atalkd last, since without it the plumbing goes away.
- if [ -x @prefix@/sbin/atalkd ]; then
- killproc atalkd
- RETVAL_ATALKD=$?
- fi
- fi
-
- # kill this separately as we also do AFP/tcp
- if [ x"${AFPD_RUN}" = x"yes" -a -x @prefix@/sbin/afpd ]; then
- killproc afpd
- RETVAL_AFPD=$?
- fi
-
- if [ $RETVAL_ATALKD -eq 0 -a $RETVAL_PAPD -eq 0 -a $RETVAL_AFPD -eq 0 ] ; then
- RETVAL=0
- rm -f /var/lock/subsys/atalk || RETVAL=1
- fi
- echo ""
- ;;
- 'restart'|'reload')
- $0 stop
- $0 start
- RETVAL=$?
- ;;
- 'status')
- status atalkd
- RETVAL=$?
- ;;
- *)
- echo "Usage: atalk {start|stop|restart|status}"
- exit 1
-esac
-
-exit $RETVAL
--- /dev/null
+#! /bin/sh
+# chkconfig: 345 91 35
+# description: This package enables Linux to talk to Macintosh
+# computers via the AppleTalk networking protocol and
+# provides printer, file sharing, and AppleTalk routing
+# services.
+#
+# AppleTalk daemons. Make sure not to start atalkd in the background:
+# its data structures must have time to stablize before running the
+# other processes.
+
+# Source function library.
+. /etc/rc.d/init.d/functions
+
+# Source networking configuration.
+. /etc/sysconfig/network
+
+test -x :SBINDIR:/atalkd || exit 0
+
+test -f :ETCDIR:/netatalk.conf || exit 0
+
+# read in netatalk configuration
+. :ETCDIR:/netatalk.conf
+
+# Check that networking is up.
+[ ${NETWORKING} = "no" ] && exit 0
+
+# initialize return values
+RETVAL=1
+RETVAL_ATALKD=0
+RETVAL_PAPD=0
+RETVAL_AFPD=0
+
+# startup code for everything
+atalk_startup() {
+ if [ x"${ATALKD_RUN}" != x"no" ]; then
+ daemon :SBINDIR:/atalkd
+ RETVAL_ATALKD=$?
+
+ if [ -x :BINDIR:/nbprgstr ]; then
+ :BINDIR:/nbprgstr -p 4 "${ATALK_NAME}:Workstation${ATALK_ZONE}"
+ :BINDIR:/nbprgstr -p 4 "${ATALK_NAME}:netatalk${ATALK_ZONE}"
+ fi
+
+ if [ x"${PAPD_RUN}" = x"yes" -a -x :SBINDIR:/papd ]; then
+ daemon :SBINDIR:/papd
+ RETVAL_PAPD=$?
+ fi
+
+ # check for timelord in bin directory
+ if [ -x :BINDIR:/timelord ]; then
+ daemon :BINDIR:/timelord
+ fi
+
+ # check for timelord in sbin directory
+ if [ -x :SBINDIR:/timelord ]; then
+ daemon :SBINDIR:/timelord
+ fi
+
+ fi
+
+ if [ x"${AFPD_RUN}" = x"yes" -a -x :SBINDIR:/afpd ] ; then
+ daemon :SBINDIR:/afpd ${AFPD_UAMLIST} -g ${AFPD_GUEST} \
+ -c ${AFPD_MAX_CLIENTS} -n "${ATALK_NAME}${ATALK_ZONE}"
+ RETVAL_AFPD=$?
+ fi
+
+ if [ $RETVAL_ATALKD -eq 0 -a $RETVAL_PAPD -eq 0 -a $RETVAL_AFPD -eq 0 ]; then
+ RETVAL=0
+ touch /var/lock/subsys/atalk || RETVAL=1
+ fi
+}
+
+case "$1" in
+'start')
+ echo -n 'Starting AppleTalk services: '
+ if [ x"${ATALK_BGROUND}" = x"yes" ]; then
+ echo -n "(backgrounded)"
+ atalk_startup >& /dev/null &
+ else
+ atalk_startup
+ fi
+ echo
+ ;;
+'stop')
+ echo -n 'Shutting down AppleTalk services: '
+ if [ x"${ATALKD_RUN}" != x"no" ]; then
+ if [ x"${PAPD_RUN}" = x"yes" -a -x :SBINDIR:/papd ]; then
+ killproc papd
+ RETVAL_PAPD=$?
+ fi
+
+ # checking for timelord in bin directory
+ if [ -x :BINDIR:/timelord ]; then
+ killproc timelord
+ fi
+
+ # checking for timelord in sbin directory
+ if [ -x :SBINDIR:/timelord ]; then
+ killproc timelord
+ fi
+
+ :BINDIR:/nbpunrgstr "${ATALK_NAME}:Workstation${ATALK_ZONE}"
+ :BINDIR:/nbpunrgstr "${ATALK_NAME}:netatalk${ATALK_ZONE}"
+
+ # kill atalkd last, since without it the plumbing goes away.
+ if [ -x :SBINDIR:/atalkd ]; then
+ killproc atalkd
+ RETVAL_ATALKD=$?
+ fi
+ fi
+
+ # kill this separately as we also do AFP/tcp
+ if [ x"${AFPD_RUN}" = x"yes" -a -x :SBINDIR:/afpd ]; then
+ killproc afpd
+ RETVAL_AFPD=$?
+ fi
+
+ if [ $RETVAL_ATALKD -eq 0 -a $RETVAL_PAPD -eq 0 -a $RETVAL_AFPD -eq 0 ] ; then
+ RETVAL=0
+ rm -f /var/lock/subsys/atalk || RETVAL=1
+ fi
+ echo ""
+ ;;
+ 'restart'|'reload')
+ $0 stop
+ $0 start
+ RETVAL=$?
+ ;;
+ 'status')
+ status atalkd
+ RETVAL=$?
+ ;;
+ *)
+ echo "Usage: atalk {start|stop|restart|status}"
+ exit 1
+esac
+
+exit $RETVAL
-# Makefile.am for man/man8/
+## Makefile.am for man/man8/
+
+SUFFIXES = .tmpl .
+
+.tmpl:
+ sed -e s@:SBINDIR:@${sbindir}@ \
+ -e s@:BINDIR:@${bindir}@ \
+ -e s@:ETCDIR:@${CONFIG_DIR}@ \
+ -e s@:LIBDIR:@${libdir}@ \
+ <$^ >$@
man_MANS = afpd.8 atalkd.8 pap.8 papd.8 papstatus.8 psf.8
+CLEANFILES = afpd.8 atalkd.8 pap.8 papd.8 papstatus.8 psf.8
+
EXTRA_DIST = $(man_MANS)
+++ /dev/null
-.TH AFPD 8 "23 Feb 1999" "netatalk 1.4b2/asun 2.1.3"
-
-.SH NAME
-afpd \- AppleTalk Filing Protocol daemon
-.SH SYNOPSIS
-.B :SBINDIR:/afpd
-[
-.B -d
-]
-[
-.B -f
-.I defaultvolumes
-]
-[
-.B -s
-.I systemvolumes
-]
-[
-.B -u
-]
-[
-.B -n
-.I nbpname
-]
-[
-.B -c
-.I maxconnections
-]
-[
-.B -g
-.I guest
-]
-[
-.B -G
-]
-[
-.B -K
-]
-[
-.B -C
-]
-[
-.B -A
-]
-.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 .
-The list of volumes offered to the user is generated from
-.B :ETCDIR:/AppleVolumes.system
-and one of
-.BR :ETCDIR:/AppleVolumes.default ,
-.BR $HOME/AppleVolumes ,
-or
-.BR $HOME/.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.
-.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
-.B \-G
-.TP
-.B \-K
-.TP
-.B \-C
-.TP
-.B \-A
-Causes the server to not offer
-.BR NoUserAuthent ,
-.BR "Kerberos IV" ,
-.BR "Cleartxt Passwrd" ,
-and
-.B AFS Kerberos
-logins, respectively. The default is to enable all available login methods.
-.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 $HOME/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 $HOME/AppleVolumes
-so that his home directory is no longer offered, he will no longer be able
-to edit his
-.B $HOME/AppleVolumes
-from the Macintosh.
-.LP
-Unix files beginning with `.' are not accessible from the mac.
-.LP
-If the
-.I pathname
-in an
-.B $HOME/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 $HOME/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.
-.SH FILES
-.TP 20
-.B :ETCDIR:/AppleVolumes.default
-list of default volumes to mount
-.TP 20
-.B :ETCDIR:/AppleVolumes.system
-list of volumes to offer all users
-.TP 20
-.B $HOME/AppleVolumes
-user's list of volumes to mount
-.SH BUGS
-A few calls from the AFP specification are not implemented, because the
-Macintosh does not use them.
--- /dev/null
+.TH AFPD 8 "23 Feb 1999" "netatalk 1.4b2/asun 2.1.3"
+
+.SH NAME
+afpd \- AppleTalk Filing Protocol daemon
+.SH SYNOPSIS
+.B :SBINDIR:/afpd
+[
+.B -d
+]
+[
+.B -f
+.I defaultvolumes
+]
+[
+.B -s
+.I systemvolumes
+]
+[
+.B -u
+]
+[
+.B -n
+.I nbpname
+]
+[
+.B -c
+.I maxconnections
+]
+[
+.B -g
+.I guest
+]
+[
+.B -G
+]
+[
+.B -K
+]
+[
+.B -C
+]
+[
+.B -A
+]
+.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 .
+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.
+.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
+.B \-G
+.TP
+.B \-K
+.TP
+.B \-C
+.TP
+.B \-A
+Causes the server to not offer
+.BR NoUserAuthent ,
+.BR "Kerberos IV" ,
+.BR "Cleartxt Passwrd" ,
+and
+.B AFS Kerberos
+logins, respectively. The default is to enable all available login methods.
+.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.
+.SH FILES
+.TP 20
+.B :ETCDIR:/AppleVolumes.default
+list of default volumes to mount
+.TP 20
+.B :ETCDIR:/AppleVolumes.system
+list of volumes to offer all users
+.TP 20
+.B ~/AppleVolumes
+user's list of volumes to mount
+.SH BUGS
+A few calls from the AFP specification are not implemented, because the
+Macintosh does not use them.
+++ /dev/null
-.TH ATALKD 8 "17 Nov 1995" "netatalk 1.3"
-.SH NAME
-atalkd \- AppleTalk RTMP, NBP, ZIP, and AEP manager
-.SH SYNOPSIS
-.B :SBINDIR:/atalkd
-[
-.B -f
-.I configfile
-] [
-.B -1
-|
-.B -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
-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).
-.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
-.nf
-le0
-le1 -seed -net 9461-9471 -zone netatalk -zone Argus
-.fi
-.RE
-.sp
-.B atalkd
-automatically acts as a router if there is more than one interface.
-.SH FILES
-.TP 30
-.B :ETCDIR:/atalkd.conf
-configuration file
-.SH BUGS
-On some systems, atalkd can not be restarted.
--- /dev/null
+.TH ATALKD 8 "17 Nov 1995" "netatalk 1.3"
+.SH NAME
+atalkd \- AppleTalk RTMP, NBP, ZIP, and AEP manager
+.SH SYNOPSIS
+.B :SBINDIR:/atalkd
+[
+.B -f
+.I configfile
+] [
+.B -1
+|
+.B -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
+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).
+.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
+.nf
+le0
+le1 -seed -net 9461-9471 -zone netatalk -zone Argus
+.fi
+.RE
+.sp
+.B atalkd
+automatically acts as a router if there is more than one interface.
+.SH FILES
+.TP 30
+.B :ETCDIR:/atalkd.conf
+configuration file
+.SH BUGS
+On some systems, atalkd can not be restarted.
+++ /dev/null
-.TH PAP 8 "13 Dec 1991" "netatalk 1.2"
-.SH NAME
-.B pap
-\- download files to or communicate interactively with an
-AppleTalk network connected printer
-.SH SYNOPSIS
-.B :SBINDIR:/pap
-[
-.BI -d
-] [
-.B -p
-.I printer
-] [
-.B -s
-.I statusfile
-] [
-.I files
-]
-.SH DESCRIPTION
-.B pap
-is used to connect and send files to an AppleTalk connected printer using
-the Apple Printer Access Protocol (PAP).
-.B pap
-can also be used to conduct an interactive session with a PostScript
-printer. When
-.B pap
-starts execution, it first tries obtain the status of the printer. It
-then tries to open a session with the printer using PAP, and
-then downloads the
-.I files
-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 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. 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.
-.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)
-for hints on how to use it this way.
-.SH OPTIONS
-.HP
-.B -p
-.I printer
-.br
-Connect to the printer named
-.I printer
-(do not consult the
-.B .paprc
-file to find a printer name). The syntax for
-.I printer
-is the same as discussed above for the
-.B .paprc
-file.
-.HP
-.B -s
-.I statusfile
-.br
-Update the file called
-.I statusfile
-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 lpd (8)
-within
-.BR lpd 's
-spool directory.
-.HP
-.B -c
-.br
-Take cuts. The PAP protocol specified a simple queuing procedure, such
-that the clients tell the printer how long they've been waiting to
-print. This option causes
-.B pap
-to lie about how long it's been waiting.
-.HP
-.B -e
-.br
-Send stdout to stderr. This causes information that the printer
-returns to be recorded as error output for lpd.
-.HP
-.B -E
-.br
-Don't wait for EOF from the printer. This option is useful for
-printers which don't implement PAP correctly. In a correct
-implementation, the client side should wait for the printer to return
-EOF before closing the connection. Some clients don't wait, and hence
-some printers have related bugs in their implementation.
-.HP
-.B -w
-.br
-Wait for the printer's status to contain the word "waiting" 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 that contains printer name
-.TP 20
-.B $HOME/.paprc
-secondary file to look in for printer name
-.SH SEE ALSO
-.BR nbp (1),
-.BR pap (4),
-.BR lpd (8),
-.BR papstatus (8),
-.BR psf (8).
-.SH BUGS
-.B pap
-will send a
-.B quit
-command to exit interactive mode when it gets an end-of-file
-on a tty. If the user has already typed
-.B quit
-themselves, the
-.B quit
-that
-.B pap
-sends is spurious and will cause a PostScript error. The fix would be for
-.B pap
-to watch what the user types and look for quit, but this is impractical.
--- /dev/null
+.TH PAP 8 "13 Dec 1991" "netatalk 1.2"
+.SH NAME
+.B pap
+\- download files to or communicate interactively with an
+AppleTalk network connected printer
+.SH SYNOPSIS
+.B :SBINDIR:/pap
+[
+.BI -d
+] [
+.B -p
+.I printer
+] [
+.B -s
+.I statusfile
+] [
+.I files
+]
+.SH DESCRIPTION
+.B pap
+is used to connect and send files to an AppleTalk connected printer using
+the Apple Printer Access Protocol (PAP).
+.B pap
+can also be used to conduct an interactive session with a PostScript
+printer. When
+.B pap
+starts execution, it first tries obtain the status of the printer. It
+then tries to open a session with the printer using PAP, and
+then downloads the
+.I files
+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 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. 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.
+.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)
+for hints on how to use it this way.
+.SH OPTIONS
+.HP
+.B -p
+.I printer
+.br
+Connect to the printer named
+.I printer
+(do not consult the
+.B .paprc
+file to find a printer name). The syntax for
+.I printer
+is the same as discussed above for the
+.B .paprc
+file.
+.HP
+.B -s
+.I statusfile
+.br
+Update the file called
+.I statusfile
+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 lpd (8)
+within
+.BR lpd 's
+spool directory.
+.HP
+.B -c
+.br
+Take cuts. The PAP protocol specified a simple queuing procedure, such
+that the clients tell the printer how long they've been waiting to
+print. This option causes
+.B pap
+to lie about how long it's been waiting.
+.HP
+.B -e
+.br
+Send stdout to stderr. This causes information that the printer
+returns to be recorded as error output for lpd.
+.HP
+.B -E
+.br
+Don't wait for EOF from the printer. This option is useful for
+printers which don't implement PAP correctly. In a correct
+implementation, the client side should wait for the printer to return
+EOF before closing the connection. Some clients don't wait, and hence
+some printers have related bugs in their implementation.
+.HP
+.B -w
+.br
+Wait for the printer's status to contain the word "waiting" 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 that contains printer name
+.TP 20
+.B ~/.paprc
+secondary file to look in for printer name
+.SH SEE ALSO
+.BR nbp (1),
+.BR pap (4),
+.BR lpd (8),
+.BR papstatus (8),
+.BR psf (8).
+.SH BUGS
+.B pap
+will send a
+.B quit
+command to exit interactive mode when it gets an end-of-file
+on a tty. If the user has already typed
+.B quit
+themselves, the
+.B quit
+that
+.B pap
+sends is spurious and will cause a PostScript error. The fix would be for
+.B pap
+to watch what the user types and look for quit, but this is impractical.
+++ /dev/null
-'\" t
-.TH PAPD 8 "17 Apr 1995" "netatalk 1.3.3"
-.SH NAME
-papd \- AppleTalk print server daemon
-.SH SYNOPSIS
-.B :SBINDIR:/papd
-[
-.B -d
-] [
-.B -f
-.I configfile
-] [
-.B -p
-.I 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.
-.LP
-.B papd
-is typically started at boot time, out of
-.B /etc/rc.
-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 .
-There are currently three supported capabilities.
-.LP
-.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 pipe to print command)
-op str ``operator'' Operator name for LPD spooling
-.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.
-.SH OPTIONS
-.TP
-.B -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
-The following papd configuration file sets up two print spoolers for the
-.B lpd
-printers named
-.B ps
-and
-.BR lp .
-The first spooler is known by the NBP name
-.B Mac Printer Spooler,
-and uses a PPD file located in
-.B /usr/share/lib/ppd.
-In addition, the user
-.B 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 Other Printer
-which prints with lpr.
-.sp
-.RS
-.nf
-Mac Printer Spooler:\\
- :pr=ps:pd=/usr/share/lib/ppd/HPLJ_4M.PPD:op=mcs:
-
-HP Printer:\\
- :
-
-Other Printer:\\
- :pr=|/usr/bin/lpr -P Otherprinter -h:
-.fi
-.RE
-.SH FILES
-.TP 16
-.B :ETCDIR:/papd.conf
-Default configuration file.
-.TP 16
-.B /etc/printcap
-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/PPDfiles
-(ftp://ftp.adobe.com/pub/adobe/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).
-.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.
--- /dev/null
+'\" t
+.TH PAPD 8 "17 Apr 1995" "netatalk 1.3.3"
+.SH NAME
+papd \- AppleTalk print server daemon
+.SH SYNOPSIS
+.B :SBINDIR:/papd
+[
+.B -d
+] [
+.B -f
+.I configfile
+] [
+.B -p
+.I 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.
+.LP
+.B papd
+is typically started at boot time, out of
+.B /etc/rc.
+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 .
+There are currently three supported capabilities.
+.LP
+.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 pipe to print command)
+op str ``operator'' Operator name for LPD spooling
+.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.
+.SH OPTIONS
+.TP
+.B -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
+The following papd configuration file sets up two print spoolers for the
+.B lpd
+printers named
+.B ps
+and
+.BR lp .
+The first spooler is known by the NBP name
+.B Mac Printer Spooler,
+and uses a PPD file located in
+.B /usr/share/lib/ppd.
+In addition, the user
+.B 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 Other Printer
+which prints with lpr.
+.sp
+.RS
+.nf
+Mac Printer Spooler:\\
+ :pr=ps:pd=/usr/share/lib/ppd/HPLJ_4M.PPD:op=mcs:
+
+HP Printer:\\
+ :
+
+Other Printer:\\
+ :pr=|/usr/bin/lpr -P Otherprinter -h:
+.fi
+.RE
+.SH FILES
+.TP 16
+.B :ETCDIR:/papd.conf
+Default configuration file.
+.TP 16
+.B /etc/printcap
+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/PPDfiles
+(ftp://ftp.adobe.com/pub/adobe/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).
+.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.
+++ /dev/null
-.TH PAPSTATUS 8 "17 Dec 1991"
-.SH NAME
-papstatus \- get the status of an AppleTalk-connected printer
-.SH SYNOPSIS
-.B :SBINDIR:/papstatus
-[
-.BI -d
-] [
-.B -p
-.I printer
-] [
-.I retrytime
-]
-.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.
-.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
-is specified, the status is obtained repeatedly, with a sleep of
-.I retrytime
-seconds between inquiring the printer.
-.SH FILES
-.TP 20
-.B .paprc
-file that contains printer name
-.SH SEE ALSO
-.BR nbp (1),
-.BR pap (8)
--- /dev/null
+.TH PAPSTATUS 8 "17 Dec 1991"
+.SH NAME
+papstatus \- get the status of an AppleTalk-connected printer
+.SH SYNOPSIS
+.B :SBINDIR:/papstatus
+[
+.BI -d
+] [
+.B -p
+.I printer
+] [
+.I retrytime
+]
+.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.
+.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
+is specified, the status is obtained repeatedly, with a sleep of
+.I retrytime
+seconds between inquiring the printer.
+.SH FILES
+.TP 20
+.B .paprc
+file that contains printer name
+.SH SEE ALSO
+.BR nbp (1),
+.BR pap (8)
+++ /dev/null
-.TH PSF 8 "17 Dec 1991" "netatalk 1.2"
-.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
-]
-.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.
-.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
-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
-.nf
-laser|lp|LaserWriter Plus on AppleTalk:\\
- :sd=/usr/spool/lpd/laser:\\
- :lp=/usr/spool/lpd/laser/null:\\
- :lf=/var/adm/lpd-errs:pw#80:hl:\\
- :of=:LIBDIR:/filters/ofpap:\\
- :if=:LIBDIR:/filters/ifpaprev:\\
- :tf=:LIBDIR:/filters/tfpaprev:\\
- :df=:LIBDIR:/filters/dfpaprev:
-.fi
-.RE
-.sp
-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
-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).
--- /dev/null
+.TH PSF 8 "17 Dec 1991" "netatalk 1.2"
+.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
+]
+.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.
+.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
+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
+.nf
+laser|lp|LaserWriter Plus on AppleTalk:\\
+ :sd=/usr/spool/lpd/laser:\\
+ :lp=/usr/spool/lpd/laser/null:\\
+ :lf=/var/adm/lpd-errs:pw#80:hl:\\
+ :of=:LIBDIR:/filters/ofpap:\\
+ :if=:LIBDIR:/filters/ifpaprev:\\
+ :tf=:LIBDIR:/filters/tfpaprev:\\
+ :df=:LIBDIR:/filters/dfpaprev:
+.fi
+.RE
+.sp
+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
+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).
projects / netatalk.git / commitdiff