Get APLawrence.com by RSSBest of the Newsgroups: install hylafax osr5
What is this stuff?
If this isn't exactly what you wanted, please try our Search (there's a LOT of techy and non-techy stuff here about Linux, Unix, Mac OS X and just computers in general!):
From: dowagiac_2000@yahoo.com (Matt Lewis) Subject: Hylafax setup howto - OpenServer 5.0.x Date: 26 Jun 2003 15:24:41 -0700 Installing Hylafax on SCO OpenServer 5.0.x June 25th, 2003 Summary: Hylafax is a complete opensource fax package for Unix based systems. Ability to send faxes and or emails using ASCII, Tiff, Postscript and PDF input.
Server/client accessibility and strict control of who can send faxes. Mail to fax gateway ready and easily integrated into existing sendmail setups. Tools and utilities to allow for web based and MS outlook fax integration. Email or fax based delivery and error notification for authorized senders. Requirements: Hylafax >= 4.1 Gawk >= 3.0 Ghostscript >= 6.51 Fileutils >= 3.16 Bash >=2.03 Glib >=1.5 Mawk >= 1.3 Zlib >=1.1 Aft-tar.Z (Adobe font files) The above packages except the (Adobe font files) are part of Skunkware for OpenServer distribution located at <ftp://ftp2.caldera.com/pub/skunkware/osr5/vols/> The (Adobe font files ) may be commonly found by searching the internet for afm-tar.Z 1. Install the above packages using custom in the following order. a. gawk b. ghostscript c. fileutils d. bash e. Glib f. Mawk g. Zlib h. Hylafax
2. Use faxsetup script attached at end of this posting. Move this to
/usr/local/sbin/faxsetup on the target host. The default faxsetup
script included with the hylafax package will not work.
3. Figure out the what tty's your fax modems are on. The quickest way
to determine this is ( tail /usr/lib/uucp/Devices )
4. Disable the tty in question. Exa. # disable tty1A . The faxsetup
script will not be able to probe the modem capabilities without the
tty disabled.
5. Run ( /usr/local/sbin/faxsetup ) . Follow the prompts. Leaving the
defaults as are. If this is the first time you install this. Answer
yes to run
faxaddmodem to add a new fax modem.
6. Setup init script. Use the hylafax.sh script shown at the end of
this posting
( cp hylafax.sh /etc/init.d/hylafax )
( ln -s /etc/init.d/hylafax /etc/rc0.d/K92hylafax )
( ln -s /etc/init.d/hylafax /etc/rc2.d/S92hylafax )
7. Start fax daemon and client. ( /etc/init.d/hylafax start )
8. Install Adobe fonts
( cp afm-tar.Z /usr/local/share/ghostscript/fonts/ )
( uncompress afm-tar.Z )
( tar xAvf afm-tar )
( mv afm/* ./ )
( rmdir afm )
9. Re-enable tty. Exa ( enable tty1A )
10. Test sending a fax. ( sendfax -d <number> <file> )
There are many other options for the fax packages.
Some useful utilities include
1. faxmail
2. faxrm
3. faxstat
4. faxcover
Many other options are available. See www.hylafax.org
<http://www.hylafax.org> for more details.
A very nice client package for hylafax for use on windows is at
http://www.cypheus.de/frm_home_e.htm
It is windows client software for integration with hylafax and allows
many options. Like custom cover pages for each person. Fax address
book. Word and
Outlook integration etc..
# Hylafax init script Copy this and put into file hylafax to put in
/etc/init.d/hylafax
#!/bin/sh
case $1 in
'start') /usr/local/sbin/hfaxd -i hylafax ;
/usr/local/sbin/faxmodem tty1A
/usr/local/sbin/faxq ;;
'stop') kill `ps -e | grep " faxq$" | cut -f2 -d" "`;
kill `ps -e | grep " hfaxd$" | cut -f2 -d" "`;;
*) /bin/echo "$0 start or $0 stop";;
esac
#---------- End hylafax init script ---------
# -=-------------- Faxsetup script Copy this and put into file
faxsetup ------------------
#! /usr/local/bin/bash
# $Id: faxsetup.sh.in,v 1.7 1999/08/05 11:11:42 robert Exp $
#
# Warning, this file was automatically created by the HylaFAX
configure script
#
# HylaFAX Facsimile Software
#
# Copyright (c) 1990-1996 Sam Leffler
# Copyright (c) 1991-1996 Silicon Graphics, Inc.
# HylaFAX is a trademark of Silicon Graphics
#
# Permission to use, copy, modify, distribute, and sell this software
and
# its documentation for any purpose is hereby granted without fee,
provided
# that (i) the above copyright notices and this permission notice
appear in
# all copies of the software and related documentation, and (ii) the
names of
# Sam Leffler and Silicon Graphics may not be used in any advertising
or
# publicity relating to the software without the specific, prior
written
# permission of Sam Leffler and Silicon Graphics.
#
# THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND,
# EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
# WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
#
# IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
# ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY
KIND,
# OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
PROFITS,
# WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY
THEORY OF
# LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE
# OF THIS SOFTWARE.
#
#
# VERSION: 4.1beta2
# DATE: Tue Feb 6 10:48:33 PST 2001
# TARGET: i386-pc-sco3.2v5.0.5
#
#
# faxsetup [options]
#
# This script interactively prepares and verifies
# a HylaFAX client and/or server machine for use.
#
PATH=/bin:/usr/bin:/etc
test -d /usr/ucb && PATH=$PATH:/usr/ucb # Sun and others
test -d /usr/bsd && PATH=$PATH:/usr/bsd # Silicon Graphics
test -d /usr/5bin && PATH=/usr/5bin:$PATH:/usr/etc # Sun and others
test -d /usr/sbin && PATH=/usr/sbin:$PATH # 4.4BSD-derived
test -d /usr/local/bin && PATH=$PATH:/usr/local/bin # for GNU tools
AWK=/usr/local/bin/mawk # awk for use below
CAT=/bin/cat # cat command for use below
CHGRP=/usr/local/bin/chgrp # change file group for use below
CHMOD=/usr/local/bin/chmod # change file mode for use below
CHOWN=/usr/local/bin/chown # change file owner for use below
CP=/usr/local/bin/cp # cp command for use below
ECHO=/bin/echo # echo command for use below
GREP=/bin/grep # grep command for use below
LN=/usr/local/bin/ln # ln command for use below
LN_S=-s # ln option for creating a symbolic link
MKFIFO=/usr/local/bin/mkfifo # FIFO creation program for use below
MV=/usr/local/bin/mv # move file for use below
RMCMD=/usr/local/bin/rm # remove file for use below
SCRIPT_SH=/usr/local/bin/bash # shell for use below
SED=/bin/sed # sed for use below
FAX=fax # identity of the fax user
SERVICES=/etc/services # location of services database
INETDCONF=/usr/etc/inetd.conf # default location of inetd
configuration file
ALIASES=/usr/lib/aliases # default location of mail aliases database
file
PASSWD=/etc/passwd # where to go for password entries
PROTOUID=uucp # user who's uid we use for FAX user
defPROTOUID=3 # use this uid if PROTOUID doesn't exist
GROUP=/etc/group # where to go for group entries
PROTOGID=uucp # group who's gid we use for FAX user
defPROTOGID=10 # use this gid if PROTOGID doesn't exist
VERSION="4.1beta2" # configured version
DATE="Tue Feb 6 10:48:33 PST 2001" # data software was configured
TARGET="i386-pc-sco3.2v5.0.5" # configured target
PATH_AFM=/usr/local/share/ghostscript/5.50:/usr/local/share/ghostscript/fonts #
directory for Adobe Font Metric files
DIR_BIN=/usr/local/bin # directory for client applications
DIR_LIBDATA=/usr/local/lib/fax # directory for client data files
DIR_LIBEXEC=/usr/local/sbin # directory where servers are located
DIR_LOCKS=/usr/spool/uucp # UUCP locking directory
DIR_MAN=/usr/local/man # directory for manual pages
DIR_SBIN=/usr/local/sbin # directory for server applications
DIR_SPOOL=/var/spool/fax # top of fax spooling tree
TIFFBIN=/usr/local/bin # TIFF tools
LOCKS=-ascii # UUCP lock type
PATH_GETTY=/etc/getty # pathname for getty program
PATH_SENDMAIL=/usr/lib/sendmail # pathname for sendmail
PATH_VGETTY=/bin/vgetty # pathname for voice getty program
PATH_EGETTY=/bin/egetty # pathname for external getty program
PS=gs # default PostScript RIP package
PATH_GSRIP=/usr/local/bin/gs # pathname of Ghostscript RIP
PATH_DPSRIP=/usr/local/sbin/ps2fax.exe # pathname of old IRIX DPS RIP
PATH_IMPRIP=/usr/lib/print/psrip # pathname of IRIX Impressario RIP
POSIXLY_CORRECT=1; export POSIXLY_CORRECT # disable GNU extensions
#
# Location of sysv init script
#
SYSVINIT=/etc/init.d/hylafax
FAXQ_SERVER=1
HFAXD_SERVER=1
#
# These are the configuration parameters written to the
# setup.cache file and read in by all the HylaFAX scripts.
#
# We use the same names used by configure for consistency
# (but some confusion within this script).
#
VARS="SCRIPT_SH
FONTPATH PATH_AFM
AWK
BIN DIR_BIN
CAT
CHGRP
CHMOD
CHOWN
CP
DPSRIP PATH_DPSRIP
ECHO
FAXQ_SERVER
GREP
GSRIP PATH_GSRIP
HFAXD_SERVER
IMPRIP PATH_IMPRIP
LIBDATA DIR_LIBDATA
LIBEXEC DIR_LIBEXEC
LN
MANDIR DIR_MAN
MKFIFO
MV
PATH
PATHGETTY PATH_GETTY
PATHVGETTY PATH_VGETTY
PATHEGETTY PATH_EGETTY
PSPACKAGE PS
RM RMCMD
SBIN DIR_SBIN
SED
SENDMAIL PATH_SENDMAIL
SPOOL DIR_SPOOL
SYSVINIT
TIFFBIN
UUCP_LOCKDIR DIR_LOCKS
UUCP_LOCKTYPE LOCKS"
dumpvals()
{
echo "$VARS" |
while read a b; do eval c=\$${b:-$a}; echo "$a='$c'"; done
}
#
# Error diagnostics that should go to the terminal are
# done with this interface or cat.
#
bitch()
{
echo "$@" 1>&2
}
#
# This is the preferred interface for
# configure to terminate abnormally.
#
boom()
{
$RM $JUNK
exit 1
}
usage()
{
cat<<EOF
Usage: faxsetup [options] [host]
Options: [defaults in brackets after descriptions]
-client setup client support
-server setup server support
-with-PARAM[=ARG] set configuration PARAM [ARG=yes]
-help print this message
-quiet do not print 'Using ...' messages
-verbose opposite of -quiet
EOF
}
QUIET=no
isServer=no
isClient=no
onClient()
{
test $isClient = yes
}
onServer()
{
test $isServer = yes
}
#
# Crack command line arguments. We purposely
# use syntax and options that are compatible
# with GNU autoconf.
#
WITHARGS=no
ac_prev=
for ac_option
do
if [ -n "$ac_prev" ]; then # assign the argument to previous
option
eval "$ac_prev=\$ac_option"
ac_prev=
continue
fi
case "$ac_option" in # collect optional argument
-*=*) ac_optarg=`echo "$ac_option" | sed 's/[-_a-zA-Z0-9]*=//'`;;
*) ac_optarg=;;
esac
case "$ac_option" in
-with-*|--with-*)
ac_with=`echo $ac_option|sed -e 's/-*with-//' -e 's/=.*//'`
# Reject names that are not valid shell variable names.
if [ -n "`echo $ac_with| sed 's/[-_a-zA-Z0-9]//g'`" ]; then
bitch "configure: $ac_with: invalid parameter name."
die
fi
ac_with=`echo $ac_with| sed 's/-/_/g'`
case "$ac_option" in
*=*) ;;
*) ac_optarg=yes;;
esac
eval "${ac_with}='$ac_optarg'"
WITHARGS=yes
;;
-client) isClient=yes;;
-server) isServer=yes;;
-quiet) QUIET=yes;;
-verbose) QUIET=no;;
-help) usage; exit 0;;
-*)
bitch "faxsetup: $ac_option: invalid option; use -help for usage."
boom
;;
esac
done
if [ -n "$ac_prev" ]; then
bitch "faxsetup: missing argument to --`echo $ac_prev | sed
's/_/-/g'`"
boom
fi
# if nothing specified on command line, default client+server
if [ $isClient = no -a $isServer = no ]; then
isClient=yes
isServer=yes
fi
#
# Descriptor usage:
# 1: ???
# 2: messages that should be seen even if we're in the background.
# 3: [stdout from test runs]
# 4: verbose-style messages (Using ...)
# 5: setup.cache file
#
if [ $QUIET = yes ]; then
exec 4>/dev/null # chuck messages
else
exec 4>&1 # messages go to stdout
fi
Note()
{
echo "$@" 1>&4
}
Note ""
Note "Setup program for HylaFAX (tm) $VERSION."
Note ""
Note "Created for $TARGET on $DATE."
Note ""
CPU=`expr $TARGET : '\(.*\)-.*-.*'` || CPU=unknown
VENDOR=`expr $TARGET : '.*-\(.*\)-.*'` || VENDOR=unknown
OS=`expr $TARGET : '.*-.*-\([a-zA-z]*\).*'` || OS=unknown
RELEASE=`(uname -r) 2>/dev/null` || RELEASE=unknown
#
# Read in any site, target, vendor, os, or os-release
# specific setup work. Note that we read stuff here
# so that configuration parameters can be altered. We
# use some pre-defined function names below to provide
# hooks for other actions.
#
#
# Hooks for additional client+server checks
#
otherBasicServerChecks()
{
true
}
otherBasicClientChecks()
{
true
}
#
# Hook for adding stuff to setup.modem
#
dumpOtherModemFuncs()
{
true
}
#
# Figure out which brand of echo we have and define prompt
# and printf shell functions accordingly. Note that we
# assume that if the System V-style echo is not present,
# then the BSD printf program is available. These functions
# are defined here so that they can be tailored on a per-site,
# etc. basis.
#
if [ `echo foo\\\c`@ = "foo@" ]; then
# System V-style echo supports \r
# and \c which is all that we need
prompt()
{
echo "$* \\c"
}
printf()
{
echo "$*\\c"
}
dumpPromptFuncs()
{
cat<<-'EOF'
prompt()
{
echo "$* \\c"
}
printf()
{
echo "$*\\c"
}
EOF
}
elif [ "`echo -n foo`@" = "foo@" ]; then
# BSD-style echo; use echo -n to get
# a line without the trailing newline
prompt()
{
echo -n "$* "
}
dumpPromptFuncs()
{
cat<<-'EOF'
prompt()
{
echo -n "$* "
}
EOF
}
else
# something else; do without
prompt()
{
echo "$*"
}
dumpPromptFuncs()
{
cat<<-'EOF'
prompt()
{
echo "$*"
}
EOF
}
fi
if onServer; then
#
# Setup the password file manipulation functions according
# to whether we have System-V style support through the
# passmgmt program, or BSD style support through the chpass
# program, or for SCO boxes through pwconv, or SVR4 style support
# through useradd. If none are found, we setup functions that
# will cause us to abort if we need to munge the password file.
#
# NB: some systems override these function definitions through
# per-os faxsetup files
#
if [ -f /bin/passmgmt -o -f /usr/sbin/passmgmt ]; then
addPasswd()
{
passmgmt -o -a -c 'Facsimile Agent' -h $4 -u $2 -g $3 $1
}
deletePasswd()
{
passmgmt -d $1
}
modifyPasswd()
{
passmgmt -m -h $4 -u $2 -o -g $3 $1
}
lockPasswd()
{
passwd -l $1
}
elif [ -f /usr/bin/chpass ]; then
addPasswd()
{
chpass -a "$1:*:$2:$3::0:0:Facsimile Agent:$4:"
}
modifyPasswd()
{
chpass -a "$1:*:$2:$3::0:0:Facsimile Agent:$4:"
}
lockPasswd()
{
return 0 # entries are always locked
}
elif [ -f /etc/pwconv ]; then # could be a SCO box
addPasswd()
{
echo "${1}:NOLOGIN:${2}:${3}:Facsimile Agent:${4}:" >> ${PASSWD}
/etc/pwconv
}
lockPasswd()
{
return 0 # entries are always locked
}
elif [ -f /usr/sbin/useradd -o -f /etc/useradd ]; then
addPasswd()
{
useradd -c 'Facsimile Agent' -d $4 -u $2 -o -g $3 $1
}
deletePasswd()
{
userdel $1
}
modifyPasswd()
{
usermod -m -d $4 -u $2 -o -g $3 $1
}
lockPasswd()
{
passwd -l $1
}
else
addPasswd()
{
cat >&2 <<EOF
FATAL ERROR: I don't know how to add a passwd entry!
You will have to create the password entry manually using the
following info:
Login Name: $1
Password: *
Uid: $2
Gid: $3
Full Name: Facsimile Agent
Home Dir: $4
EOF
boom
}
modifyPasswd()
{
cat >&2 <<EOF
FATAL ERROR: I don't know how to modify a passwd entry!
You will have to update the password entry manually using the
following info:
Login Name: $1
Password: *
Uid: $2
Gid: $3
Full Name: Facsimile Agent
Home Dir: $4
EOF
boom
}
fi
#
# Functions required by faxaddmodem.
#
case $TARGET in
*-sunos*|*-linux*|*-ultrix*|*-hpux*|*-freebsd*|*-netbsd*)
dumpTTYFuncs()
{
cat<<'EOF'
ttyPort()
{
expr $1 : 'tty\(.*\)'
}
ttyLocks()
{
echo $UUCP_LOCKDIR/LCK..$1
}
ttyAliases()
{
echo /dev/$1
}
ttyDev()
{
echo /dev/$1
}
checkPort()
{
return
}
EOF
}
;;
*-svr4*|*-sysv4*|*-solaris*)
dumpTTYFuncs()
{
cat<<'EOF'
ttyPort()
{
port=`expr $1 : 'term\/\(.*\)' \| $1` # Usual
port=`expr $port : 'cua\/\(.*\)' \| $port` # Solaris
port=`expr $port : 'tty\(.*\)' \| $port` # Old-style
echo $port
}
ttyLocks()
{
devs=$1
locks="$UUCP_LOCKDIR/`$SVR4UULCKN /dev/$devs`" || {
echo "Sorry, I cannot determine the UUCP lock file name for
$devs"
exit 1
}
echo $locks
}
ttyAliases()
{
echo /dev/$1
}
ttyDev()
{
echo /dev/$1
}
checkPort()
{
return
}
EOF
}
;;
*)
dumpTTYFuncs()
{
Note ""
Note "Beware, I am guessing the tty naming conventions for your
system."
cat<<'EOF'
ttyPort()
{
expr $1 : 'tty\(.*\)'
}
ttyLocks()
{
echo $UUCP_LOCKDIR/LCK..$1
}
ttyAliases()
{
echo /dev/$1
}
ttyDev()
{
echo /dev/$1
}
checkPort()
{
return
}
EOF
}
;;
esac
case $TARGET in
*-*bsd*)
dumpSTTYFuncs()
{
cat<<EOF
ttyStty()
{
echo $STTYCMD -f \$tdev
}
ttySpeeds()
{
speeds=
if [ -z "\$SPEED" ]; then
for s in 38400 19200 9600 4800 2400 1200; do
$STTYCMD -f \$tdev \$s </dev/null >/dev/null 2>&1 &&
speeds="\$speeds \$s"
done
fi
echo \$speeds
}
EOF
}
;;
*)
dumpSTTYFuncs()
{
cat<<EOF
ttyStty()
{
echo $STTYCMD
}
ttySpeeds()
{
speeds=
if [ -z "\$SPEED" ]; then
for s in 38400 19200 9600 4800 2400 1200; do
onDev $STTYCMD \$s </dev/null >/dev/null 2>&1 && speeds="\$speeds
\$s"
done
fi
echo \$speeds
}
EOF
}
;;
esac
machdepPasswdWork()
{
true
}
#
# Default values for new scheduler config files
#
defaultLogFacility=daemon
defaultCountryCode=1
defaultAreaCode=
defaultLongDistancePrefix=1
defaultInternationalPrefix=011
defaultDialStringRules=\"etc/dialrules\"
defaultServerTracing=1
defaultContCoverPage=
defaultContCoverCmd=\"bin/mkcover\"
defaultDestControls=
defaultMaxConcurrentJobs=1
defaultMaxDials=12
defaultMaxSendPages=0xffffffff
defaultMaxTries=3
defaultModemGroup=
defaultPostScriptTimeout=180
defaultPS2FaxCmd=\"bin/ps2fax\"
defaultSendFaxCmd=\"bin/faxsend\"
defaultSendPageCmd=\"bin/pagesend\"
defaultSendUUCPCmd=\"bin/uucpsend\"
defaultSessionTracing=0xffffffff
defaultTimeOfDay=\"Any\"
defaultUse2D=Yes
defaultNotifyCmd=\"bin/notify\"
defaultUUCPLockDir=\"$DIR_LOCKS\"
defaultUUCPLockTimeout=30
defaultUUCPLockType=\"$LOCKS\"
fi
CONFIG_FILES=
if [ -f $DIR_SBIN/faxsetup.local ]; then
. $DIR_SBIN/faxsetup.local
CONFIG_FILES="$CONFIG_FILES $DIR_SBIN/faxsetup.local"
elif [ -f $DIR_SBIN/faxsetup.${CPU}-${VENDOR}-${OS}${RELEASE} ]; then
. $DIR_SBIN/faxsetup.${CPU}-${VENDOR}-${OS}${RELEASE}
CONFIG_FILES="$CONFIG_FILES
$DIR_SBIN/faxsetup.${CPU}-${VENDOR}-${OS}${RELEASE}"
elif [ -f $DIR_SBIN/faxsetup.${VENDOR}-${OS}${RELEASE} ]; then
. $DIR_SBIN/faxsetup.${VENDOR}-${OS}${RELEASE}
CONFIG_FILES="$CONFIG_FILES
$DIR_SBIN/faxsetup.${VENDOR}-${OS}${RELEASE}"
elif [ -f $DIR_SBIN/faxsetup.${CPU}-${VENDOR}-${OS} ]; then
. $DIR_SBIN/faxsetup.${CPU}-${VENDOR}-${OS}
CONFIG_FILES="$CONFIG_FILES
$DIR_SBIN/faxsetup.${CPU}-${VENDOR}-${OS}"
elif [ -f $DIR_SBIN/faxsetup.${VENDOR}-${OS} ]; then
. $DIR_SBIN/faxsetup.${VENDOR}-${OS}
CONFIG_FILES="$CONFIG_FILES $DIR_SBIN/faxsetup.${VENDOR}-${OS}"
elif [ -f $DIR_SBIN/faxsetup.${CPU}-${VENDOR} ]; then
. $DIR_SBIN/faxsetup.${CPU}-${VENDOR}
CONFIG_FILES="$CONFIG_FILES $DIR_SBIN/faxsetup.${CPU}-${VENDOR}"
elif [ -f $DIR_SBIN/faxsetup.${VENDOR} ]; then
. $DIR_SBIN/faxsetup.${VENDOR}
CONFIG_FILES="$CONFIG_FILES $DIR_SBIN/faxsetup.${VENDOR}"
elif [ -f $DIR_SBIN/faxsetup.${OS} ]; then
. $DIR_SBIN/faxsetup.${OS}
CONFIG_FILES="$CONFIG_FILES $DIR_SBIN/faxsetup.${OS}"
fi
#
# Flush cached values if something was specified on the
# command line
#
if onServer; then
REASON=
if [ $WITHARGS = yes ]; then
REASON="of command line parameters"
elif [ "$CONFIG_FILES" ]; then
REASON=`find $CONFIG_FILES -newer $DIR_SPOOL/etc/setup.cache -print
2>/dev/null`
test "$REASON" && REASON="$REASON has been updated"
fi
if [ "$REASON" -a -f $DIR_SPOOL/etc/setup.cache ]; then
Note "Flushing cached parameters because $REASON."
Note ""
rm -f $DIR_SPOOL/etc/setup.cache
fi
if [ -f $DIR_SPOOL/etc/setup.cache ]; then
Note "Reading cached parameters from $DIR_SPOOL/etc/setup.cache."
Note ""
. $DIR_SPOOL/etc/setup.cache
fi
fi
RM="$RMCMD -f" # remove file for use below
#
# Deduce the effective user id:
# 1. POSIX-style, the id program
# 2. the old whoami program
# 3. last gasp, check if we have write permission on /dev
#
euid=`id|$SED -e 's/.*uid=[0-9]*(\([^)]*\)).*/\1/'`
test -z "$euid" && euid=`(whoami) 2>/dev/null`
test -z "$euid" -a -w /dev && euid=root
if [ "$euid" != "root" ]; then
bitch "Sorry, but you must run this script as the super-user!"
boom
fi
onClient && Note "Checking system for proper client configuration."
onServer && Note "Checking system for proper server configuration."
#
# Verify configuration parameters are correct.
#
dirMisConfigured()
{
cat >&2 <<EOF
FATAL ERROR: $1 does not exist or is not a directory!
The directory $1 does not exist or this file is not a directory. If
the HylaFAX software is not yet installed you must do so before
running
this script. If the software is installed but is configured for use
in
a different location than this script expects then the software will
not
function correctly.
EOF
boom
}
#
# Check basic spooling area setup.
#
if onServer; then
test -d $DIR_SPOOL || {
cat >&2 <<-EOF
FATAL ERROR: $DIR_SPOOL does not exist or is not a directory!
The HylaFAX spooling area $DIR_SPOOL does not exist or this file is
not a directory. If the HylaFAX software is not yet installed you
must do so before running this script. If the software is installed
but is configured for use in a different location than this script
expects then you may override the default pathname by running this
script with a -with-DIR_SPOOL option; e.g.
faxsetup -with-DIR_SPOOL=/var/spool/someplace_unexpected
EOF
boom
}
cd $DIR_SPOOL
DIRS="archive bin client config dev docq doneq etc info log\
pollq recvq sendq status tmp"
for i in $DIRS; do
test -d $i || dirMisConfigured $DIR_SPOOL/$i
done
#
# XXX should check permission and ownership of sensitive dirs
#
JUNK="etc/setup.tmp"
trap "$RM \$JUNK; exit 1" 1 2 15
exec 5>etc/setup.tmp
echo '# Warning, this file was automatically generated by
faxsetup' >&5
echo '# on' `date` "for ${USER:-$euid}" >&5
fi
#
# Basic client installation.
#
if onClient; then
test -d $DIR_BIN || dirMisConfigured $DIR_BIN
for file in sendfax sendpage faxstat faxalter faxcover faxmail
faxrm; do
test -x $DIR_BIN/$file || {
cat >&2 <<EOF
FATAL ERROR: $DIR_BIN/$file is not an executable program!
The file $DIR_BIN/$file does not exist or this file is not
an executable program. If the HylaFAX software is not yet installed
you
must do so before running this script. If the software is installed
but
is configured for use in a different location than this script expects
then the software will not function correctly.
EOF
boom
}
done
test -d $DIR_LIBDATA || dirMisConfigured $DIR_LIBDATA
for file in pagesizes faxcover.ps typerules; do
test -f $DIR_LIBDATA/$file || {
cat >&2 <<EOF
FATAL ERROR: $DIR_LIBDATA/$file does not exist!
The file $DIR_LIBDATA/$file does not exist. If the HylaFAX
software is not yet installed you must do so before running this
script.
If the software is installed but is configured for use in a different
location than this script expects then the software will not function
correctly.
EOF
boom
}
done
test -d $DIR_LIBEXEC || dirMisConfigured $DIR_LIBEXEC
for file in textfmt; do
test -f $DIR_LIBEXEC/$file || {
cat >&2 <<EOF
FATAL ERROR: $DIR_LIBEXEC/$file does not exist!
The file $DIR_LIBEXEC/$file does not exist. If the HylaFAX
software is not yet installed you must do so before running this
script.
If the software is installed but is configured for use in a different
location than this script expects then the software will not function
correctly.
EOF
boom
}
done
otherBasicClientChecks
fi
#
# Server setup other than the spooling area.
#
if onServer; then
test -d $DIR_LIBEXEC || dirMisConfigured $DIR_LIBEXEC
test -d $DIR_SBIN || dirMisConfigured $DIR_SBIN
test -d $DIR_LOCKS || {
cat >&2 <<EOF
FATAL ERROR: $DIR_LOCKS does not exist or is not a directory!
The UUCP lockfile directory is not where it is expected or this file
is not a directory. It is possible to configure the HylaFAX software
to use a directory other than the configured one by setting up the
UUCPLockDir configuration parameter in each configuration file in the
$DIR_SPOOL/etc directory, but this is potentially error-prone.
Your best bet is to either create a symbolic link for the expected
pathname or reconfigure HylaFAX with the correct pathname and build
a new distribution.
EOF
boom
}
test -d $TIFFBIN || {
cat >&2 <<EOF
FATAL ERROR: $TIFFBIN does not exist or is not a directory!
The directory of tools from the TIFF software distribution is not
where it is expected or this file is not a directory. If you do not
have the TIFF distribution installed on this machine then you must
install it; the master FTP location is
ftp://ftp.sgi.com/graphics/tiff.
Otherwise, if the software is installed in a directory other than
where it is expected you can configure the HylaFAX software to use
an alternate directory by supplying a -with-TIFFBIN option when
running
this script; e.g. faxsetup -with-TIFFBIN=someplace_nonstandard.
EOF
boom
}
for file in tiffcp tiff2ps fax2ps tiffinfo; do
test -x $TIFFBIN/$file || {
cat >&2 <<EOF
FATAL ERROR: $TIFFBIN/$file does not exist or is not an executable
program!
The program $TIFFBIN/$file is not where it is expected or the file
is not executable. This program is part of the TIFF software
distribution that is required for use with HylaFAX. If you do not
have the TIFF distribution installed on this machine then you must
install it; the master FTP location is
ftp://ftp.sgi.com/graphics/tiff.
Otherwise, if the software is installed in a directory other than
where it is expected you can configure the HylaFAX software to use
an alternate directory by supplying a -with-TIFFBIN option when
running
this script; e.g. faxsetup -with-TIFFBIN=someplace_nonstandard.
EOF
boom
}
done
otherBasicServerChecks
fi
#
# Quick check to see if the manual pages are installed;
# perhaps not even worth the effort.
#
test -d $DIR_MAN || {
cat >&4 <<EOF
Warning: $DIR_MAN does not exist or is not a directory!
The directory for manual pages does not exist or is not a directory.
If this directory does not exist because the manual pages have not
been
installed then you can ignore this message. Otherwise you may want to
check out what happened to the manual pages.
EOF
}
#
# Utility program parameters.
#
appMisConfigured()
{
cat >&2 <<EOF
FATAL ERROR: $1 does not exist or is not an executable program!
The file:
$1
does not exist or this file is not an executable program. The HylaFAX
software expects this program to exist and be in this location. If
the
program resides in a different location then you must either
reconfigure
and rebuild HylaFAX or override the default pathnames in the
distributed
software through one of the HylaFAX configuration files (consult the
HylaFAX documentation).
EOF
boom
}
warnAppMisConfigured()
{
cat >&2 <<EOF
Warning: $1 does not exist or is not an executable program!
The file:
$1
does not exist or this file is not an executable program. The
HylaFAX software optionally uses this program and the fact that
it does not exist on the system is not a fatal error. If the
program resides in a different location and you do not want to
install a symbolic link for $1 that points to your program
then you must reconfigure and rebuild HylaFAX from source code.
EOF
}
if onServer; then
test -x $PATH_GETTY || warnAppMisConfigured $PATH_GETTY
test -x $PATH_VGETTY || warnAppMisConfigured $PATH_VGETTY
test -x $PATH_EGETTY || warnAppMisConfigured $PATH_EGETTY
for i in $CAT $CHGRP $CHMOD $CHOWN $CP $ECHO $GREP $LN $MKFIFO $MV
\
$RMCMD $SED $SENDMAIL; do
test -x $i || appMisConfigured $i
done
#
# Test/verify we know how to create FIFO special files.
#
case $MKFIFO in
*mknod)
mkfifo()
{
$MKFIFO $1 p
}
;;
*)
mkfifo()
{
$MKFIFO $1
}
;;
esac
$RM conffifo; JUNK="$JUNK conffifo"
if (mkfifo conffifo && test -p conffifo) >/dev/null 2>&1; then
true
elif test -r conffifo; then # NB: not everyone has test -p
true
else
cat >&2 <<EOF
FATAL ERROR: Don't know how to create FIFO special files!
We were unable to create a FIFO special file using the command:
$MKFIFO conffifo
HylaFAX requires support for FIFO special files and will not function
without this support. If your system does not have support for FIFO
files then reconfigure it to include support (on some systems this
support is optional and requires recompilation or rebuilding of the
kernel). If your system does have support for FIFO files but they are
not created using the expected program then you will need to
reconfigure
and rebuild HylaFAX from the source distribution or emulate the needed
functionality (possibly by providing a shell script).
EOF
boom
fi
fi
#
# AWK support.
#
if onServer; then
test -x $AWK || appMisConfigured $AWK
# awk must support functions and -v
CheckAwk()
{
($1 -v BAR=bar '
function foo(x) {
print "GOT" x
}
BEGIN { foo(BAR) }
' </dev/null | grep GOTbar) >/dev/null 2>&1
return
}
CheckAwk $AWK || {
cat >&2 <<EOF
FATAL ERROR: $AWK does not support needed functionality!
The following test does not work correctly with the configured awk
program.
----------------------------------------------------------
$AWK -v BAR=bar '
function foo(x) {
print "GOT" x
}
BEGIN { foo(BAR) }
' </dev/null | grep GOTbar
----------------------------------------------------------
The HylaFAX software requires an awk program that supports functions
and
the -v option for passing parameters from the command line. The
deficiency
of $AWK on your system will cause problems in various parts of the
HylaFAX
software.
If you are running an old version of $AWK then get a more up to date
version. Otherwise you can reconfigure HylaFAX from the source
distribution
to force a different awk program to be used or you can, as a last
resort,
try altering the shell scripts that are part of HylaFAX that use $AWK.
EOF
boom
}
fi
#
# Installation of Adobe Font Metric files
#
if onClient; then
FDIRS=`echo $PATH_AFM | sed "s/:/ /g"`
MATCH=
for FDIR in $FDIRS; do
if [ -d $FDIR ]; then
cd $FDIR
if [ -n "`ls | grep '.afm'`" ] || [ -f Courier ]; then
MATCH=$FDIR
break
fi
else
cat >&4 <<EOF
Warning: $FDIR does not exist or is not a directory!
The directory $FDIR does not exist or this file is not a directory.
This is the directory where the HylaFAX client applications expect to
locate font metric information to use in formatting ASCII text for
submission as facsimile. Without this information HylaFAX may
generate
illegible facsimile from ASCII text.
EOF
fi
done
if [ -z "$MATCH" ];then
cat >&4 <<EOF
Warning: Font metric information files were not found!
The font metric information file for the Courier font was not found in
the $PATH_AFM path. This means that client HylaFAX applications
that use this information to format ASCII text for submission as fax
will
use incorrect information and generate potentially illegible
facsimile.
If font metric information is present on your system in a directory
other
than $PATH_AFM then you can setup a symbolic link to the appropriate
directory or you can specify the appropriate pathname in the
configuration
file $DIR_LIBDATA/hyla.conf with a line of the form:
FontPath: someplace_unexpected
If you do not have the font metric information files loaded on your
system
system you can obtain them by public FTP from the place where you
obtained
the HylaFAX software or from the master FTP site at ftp.sgi.com.
EOF
fi
# return to spool directory
cd $DIR_SPOOL
fi
#
# PostScript RIP support.
#
if onServer; then
case $PS in
dps) PATH_PSRIP=$PATH_DPSRIP;;
imp) PATH_PSRIP=$PATH_IMPRIP;;
gs) PATH_PSRIP=$PATH_GSRIP;;
esac
if [ -x "$PATH_PSRIP" ]; then
if [ $PS = gs ]; then
# verify Ghostscript was linked with the tiffg3 device driver
$PATH_PSRIP -h | grep tiffg3 >/dev/null 2>&1 || {
cat >&2 <<EOF
FATAL ERROR: No tiffg3 driver in $PATH_PSRIP.
HylaFAX has been configured to use Ghostscript as the PostScript
imaging program but the output of $PATH_PSRIP -h does not
list the tiffg3 driver as a configured driver (see below).
----------------------------------------------------------
% $PATH_PSRIP -h
EOF
$PATH_PSRIP -h
----------------------------------------------------------
cat >&2 <<EOF
The tiffg3 driver is required for HylaFAX to operate correctly.
Consult the documentation for information on building Ghostscript
with the necessary TIFF driver and then rerun faxsetup when a new
Ghostscript has been installed.
EOF
boom
}
elif [ $PS = dps ]; then
JUNK="$JUNK ps.fax"
$CAT etc/dpsprinter.ps | $PATH_PSRIP >/dev/null 2>&1
if [ $? -eq 2 ]; then
if expr $RELEASE \>= 6.2 >/dev/null; then
cat >&2 <<EOF
FATAL ERROR: No DPS-based RIP available for IRIX $RELEASE!
The DPS-based PostScript RIP is a COFF executable and cannot be used
under IRIX $RELEASE. You must use a different RIP such as fw_gs.sw.gs
which is found on the SGI Freeware CD-ROM and which is based on the
freely distributed Ghostscript software package. This package is
also included in the binary distribution of HylaFAX for SGI systems
found on ftp.sgi.com.
Once you have installed the Ghostscript distribution rerun faxsetup
with the option -with-PS=gs to override the default setting.
EOF
boom
fi
fi
fi
elif [ $PS = dps ]; then
if expr $RELEASE \>= 6.2 >/dev/null; then
cat >&2 <<EOF
FATAL ERROR: No DPS-based RIP available for IRIX $RELEASE!
This distribution has been configured to use the DPS-based PostScript
RIP that is only available as a COFF executable. This program cannot
be used under IRIX $RELEASE. You must use a different RIP such as the
Ghostscript-based RIP in the fw_gs.sw.gs installation image which is
found on the SGI Freeware CD-ROM. The fw_gs package is also included
in the binary distribution of HylaFAX for SGI systems found on
ftp.sgi.com.
Once you have installed the Ghostscript distribution rerun faxsetup
with the option -with-PS=gs to override the default setting.
EOF
boom
else
appMisConfigured $PATH_PSRIP
fi
else
appMisConfigured $PATH_PSRIP
fi
#
# Force bin/ps2fax to point to the appropriate script.
#
Note ""
Note "Make $DIR_SPOOL/bin/ps2fax a link to
$DIR_SPOOL/bin/ps2fax.$PS."
Note ""
$RM bin/ps2fax
if [ -n "$LN_S" ]; then
$LN $LN_S ps2fax.$PS bin/ps2fax;
else
$LN bin/ps2fax.$PS bin/ps2fax;
fi
fi
#
# Find the full pathname of a file
# using the specified test operation.
#
findThing()
{
t="$1"; app=$2; path=$3;
case $app in
/*) eval $t $app && { echo $app; return; };;
esac
IFS=:
for i in $path; do
eval $t $i/$app && { echo $i/$app; return; }
done
}
#
# Find the full pathname of an executable.
#
findApp()
{
findThing "test -x" $1 $2
}
#
# Deal with known alternate locations for system files.
#
PickFile()
{
for i do
test -f $i && { echo $i; return; }
done
echo $1
}
INETDCONF=`PickFile $INETDCONF /etc/inetd.conf /etc/inet/inetd.conf`
ALIASES=`PickFile $ALIASES /etc/aliases /etc/ucbmail/aliases
/etc/mail/aliases /usr/mmdf/table/alias.user /usr/mmdf/table/alias.n`
SERVICES=`PickFile $SERVICES /etc/inet/services`
test -f /etc/master.passwd && PASSWD=/etc/master.passwd
#
# Figure out which brand of echo we have and define
# prompt and printf shell functions accordingly.
# Note that we assume that if the System V-style
# echo is not present, then the BSD printf program
# is available.
#
t=`(printf hello) 2>/dev/null`
if [ "$t" != hello ]; then
cat >&2 <<EOF
FATAL ERROR: No printf command or emulation!
HylaFAX requires a shell-level program that understands C-style
strings
(e.g. "\r") and has a mechanism for printing a string without a
trailing
newline character. The System V echo command and the BSD/POSIX-style
printf command are known to support these functions; however your
system
does not appear to have either of these programs. If you have a
program
hidden somewhere on your system be sure to include it in the search
path
used by faxsetup:
$PATH
and then rerun faxsetup. Otherwise a printf command is included in
the
GNU shell utilities package that can be retrieved by public FTP.
EOF
boom
fi
if onServer; then
dumpPromptFuncs >&5
fi
#
# Prompt the user for a string that can not be null.
#
promptForNonNullStringParameter()
{
x=""
while [ -z "$x" ]; do
prompt "$2 [$1]?"; read x
if [ "$x" ]; then
# strip leading and trailing white space
x=`echo "$x" | $SED -e 's/^[ ]*//' -e 's/[ ]*$//'`
else
x="$1"
fi
done
param="$x"
}
#
# Prompt the user for a string that can be null.
#
promptForStringParameter()
{
prompt "$2 [$1]?"; read x
if [ "$x" ]; then
# strip leading and trailing white space
x=`echo "$x" | $SED -e 's/^[ ]*//' -e 's/[ ]*$//'`
else
x="$1"
fi
param="$x"
}
#
# Prompt the user for a numeric value.
#
promptForNumericParameter()
{
x=""
while [ -z "$x" ]; do
prompt "$2 [$1]?"; read x
if [ "$x" ]; then
# strip leading and trailing white space
x=`echo "$x" | $SED -e 's/^[ ]*//' -e 's/[ ]*$//'`
match=`expr "$x" : "\([0-9]*\)"`
if [ "$match" != "$x" ]; then
echo ""
echo "This must be entirely numeric; please correct it."
echo ""
x="";
fi
else
x="$1"
fi
done
param="$x"
}
#
# Prompt the user for a C-style numeric value.
#
promptForCStyleNumericParameter()
{
x=""
while [ -z "$x" ]; do
prompt "$2 [$1]?"; read x
if [ "$x" ]; then
# strip leading and trailing white space and C-style 0x prefix
x=`echo "$x" | $SED -e 's/^[ ]*//' -e 's/[ ]*$//'`
match=`expr "$x" : "\([0-9]*\)" \| "$x" : "\(0x[0-9a-fA-F]*\)"`
if [ "$match" != "$x" ]; then
echo ""
echo "This must be entirely numeric; please correct it."
echo ""
x="";
fi
else
x="$1"
fi
done
param="$x"
}
#
# Prompt the user for a boolean value.
#
promptForBooleanParameter()
{
x=""
while [ -z "$x" ]; do
prompt "$2 [$1]?"; read x
if [ "$x" ]; then
# strip leading and trailing white space
x=`echo "$x" | $SED -e 's/^[ ]*//' -e 's/[ ]*$//'`
case "$x" in
n|no|off) x=no;;
y|yes|on) x=yes;;
*)
cat <<EOF
"$x" is not a valid boolean parameter setting;
use one of: "yes", "on", "no", or "off".
EOF
x="";;
esac
else
x="$1"
fi
done
param="$x"
}
#
# Compile a table of configuration parameters prompts into
# a shell program that can be ``eval'd'' to prompt the user
# for changes to the current parameter settings.
#
compilePrompts()
{
$AWK -F'[ ]+' '
function p(t)
{
printf "promptFor%sParameter \"$%s\" \"%s\";%s=\"$param\"\n", t,
$2, $3, $2
}
$1 == "#" { p("Numeric"); next }
$1 == "C#" { p("CStyleNumeric"); next }
$1 == "S" { p("String"); next }
$1 == "NNS" { p("NonNullString"); next }
$1 == "B" { p("Boolean"); next }
{ printf "promptFor%s\n", $1 }
'
}
faxUID=`grep "^$PROTOUID:" $PASSWD | cut -d: -f3`
if [ -z "$faxUID" ]; then faxUID=$defPROTOUID; fi
faxGID=`grep "^$PROTOGID:" $GROUP | cut -d: -f3`
if [ -z "$faxGID" ]; then faxGID=$defPROTOGID; fi
#
# Change the password file entry for the fax user.
#
fixupFaxUser()
{
emsg1=`modifyPasswd $FAX $faxUID $faxGID $DIR_SPOOL 2>&1`
case $? in
0) echo "Done, the \"$FAX\" user should now have the right user
id.";;
*) cat <<-EOF
FATAL ERROR: Command failed!
The modify password command failed with the message:
"$emsg1"
HylaFAX will not work correctly until the proper uid is setup
for it in the password file. Please fix this problem and then
rerun faxsetup.
EOF
boom
;;
esac
}
#
# Add a fax user to the password file and lock the
# entry so that noone can login as the user.
#
addFaxUser()
{
emsg1=`addPasswd $FAX $faxUID $faxGID $DIR_SPOOL 2>&1`
case $? in
0) emsg2=`lockPasswd $FAX 2>&1`
case $? in
0) echo "Added user \"$FAX\" to $PASSWD.";;
*) emsg3=`deletePasswd $FAX 2>&1`
case $? in
0|9) cat <<-EOF
Failed to add user "$FAX" to $PASSWD because the
attempt to lock the password failed with:
"$emsg2"
Please fix this problem and rerun this script."
EOF
;;
*) cat <<-EOF
You will have to manually edit $PASSWD because
after successfully adding the new user "$FAX", the
attempt to lock its password failed with:
"$emsg2"
and the attempt to delete the insecure passwd entry failed with:
"$emsg3"
To close this security hole, you should add a password
to the "$FAX" entry in the file $PASSWD, or lock this
entry with an invalid password.
EOF
;;
esac
boom;;
esac;;
9) # fax was already in $PASSWD, but not found with grep
;;
*) cat <<-EOF
There was a problem adding user "$FAX" to $PASSWD;
the command failed with:
"$emsg1"
HylaFAX will not work until you have corrected this problem.
EOF
boom;;
esac
}
isOK()
{
x="$1"
test -z "$x" -o "$x" = y -o "$x" = yes
}
if onServer; then
x=`grep "^$FAX:" $PASSWD | cut -d: -f3`
if [ -z "$x" ]; then
echo ""
echo ""
echo "You do not appear to have a \"$FAX\" user in the password
file."
prompt "HylaFAX needs this to work properly, add it [yes]?"
read x
isOK $x && addFaxUser
elif [ "$x" != "$faxUID" ]; then
echo ""
echo ""
echo "It looks like you have a \"$FAX\" user in the password file,"
echo "but with a uid different than the uid for uucp. You probably"
echo "have old fax software installed. In order for this software"
echo "to work properly, the fax user uid must be the same as uucp."
prompt "Is it ok to change the password entry for \"$FAX\" [yes]?"
read x;
isOK $x && fixupFaxUser
fi
machdepPasswdWork
#
# Verify existence, permission and ownership of sensitive files.
# XXX there are other files too
#
HOSTS=$DIR_SPOOL/etc/hosts.hfaxd
test -f $HOSTS || {
cat<<EOF
Warning: $1 does not exist!
The file $1 does not exist or is not a regular file.
This file specifies which clients are permitted to use the HylaFAX
server. The file will be initialized so that local clients are
provided service. Consult the HTML documentation and the manual
page hosts.hfaxd(4F) for more information on setting up this file.
EOF
$RM $HOSTS
echo "localhost" >$HOSTS
echo "127.0.0.1" >>$HOSTS
}
#
# Too complicated to check contents:
# simply force correct protection and ownership
#
$CHOWN $faxUID $HOSTS; $CHGRP $faxGID $HOSTS
$CHMOD 600 $HOSTS
fi
#
# Check for services entries for hylafax and snpp.
#
hasYP=`(ypcat services) 2>/dev/null | tail -1` 2>/dev/null
x=`$GREP '^hylafax[ ]' $SERVICES 2>/dev/null` 2>/dev/null
if [ -z "$x" ]; then
if [ "$hasYP" ]; then
x=`ypcat services 2>/dev/null | $GREP '^hylafax[ ]'` 2>/dev/null
fi
if [ -z "$x" ]; then
ENTRY="hylafax 4559/tcp # HylaFAX client-server protocol"
cat<<-EOF
Warning: No hylafax service entry found!
No entry was found for the hylafax service in the YP/NIS database
or in the $SERVICES file. The software should work properly
without one (except if you want to start hfaxd from inetd), but you
will see warning messages whenever you run a HylaFAX client
application. If you want to manually add an entry the following
information should be used:
$ENTRY
EOF
prompt "Should a hylafax entry be added to $SERVICES [yes]?"
read x
isOK $x && echo "$ENTRY" >>$SERVICES
fi
fi
x=`$GREP '^snpp[ ]' $SERVICES 2>/dev/null` 2>/dev/null
if [ -z "$x" ]; then
if [ "$hasYP" ]; then
x=`ypcat services 2>/dev/null | $GREP '^snpp[ ]'` 2>/dev/null
fi
if [ -z "$x" ]; then
ENTRY="snpp 444/tcp # Simple Network Paging Protocol"
cat<<-EOF
Warning: No snpp service entry found!
No entry was found for the Simple Network Paging Protocol (SNPP)
service in the YP/NIS database or in the $SERVICES file.
The software should work properly without one (except if you want
to start hfaxd from inetd), but you will see warning messages
whenever
you run the HylaFAX sendpage program. If you want to manually add
an entry the following information should be used:
$ENTRY
EOF
prompt "Should an snpp entry be added to $SERVICES [yes]?"
read x
isOK $x && echo "$ENTRY" >>$SERVICES
fi
fi
#
# Check that for servers being started at system boot.
#
if onServer; then
signalINETD=no
if [ -f $SYSVINIT ]; then
# started by init at boot time
if [ $FAXQ_SERVER -eq 0 ]; then
cat <<EOF
Warning faxq will NOT be automatically started on reboot!
EOF
true
fi
else
$FAXQ_SERVER=0
$HFAXD_SERVER=0
fi
if [ -f $INETDCONF -a $HFAXD_SERVER -eq 0 ]; then
E="hylafax stream tcp nowait $FAX $DIR_LIBEXEC/hfaxd hfaxd -I"
editInetdConf()
{
ed - $INETDCONF<<EOF
/^hylafax[ ]*stream[ ]*tcp/d
a
$E
.
w
q
EOF
if [ $? != 0 ]; then
cat<<EOF
FATAL ERROR: Unable to correct HylaFAX entry in $INETDCONF!
We were unable to edit the $INETDCONF file to correct the entry
for starting up the HylaFAX client-server protocol process. You
must manually correct this entry so that it reads:
$E
and then rerun faxsetup.
EOF
boom
fi
}
eval `$GREP '^hylafax[ ]*stream[ ]*tcp' $INETDCONF | \
$AWK -F'[ ]+' '{ print "F=" $6 "; U=" $5 }' 2>/dev/null`
if [ -z "$F" -a -z "$U" ]; then
cat<<EOF
There is no entry for the hylafax service in $INETDCONF.
The HylaFAX client-server protocol process can be setup to run
standalone or started by the inetd program. A standalone setup
is preferred for performance reasons, especially if hfaxd is to
support multiple protocols (e.g. SNPP); however it may require
manual setup if your operating system does not have a System-V
style init program.
EOF
prompt "Should an entry be added to $INETDCONF [no]?"; read x
if [ "$x" = y -o "$x" = yes ]; then
echo "$E" >>$INETDCONF;
signalINETD=yes
fi
else
if [ "$F" != $DIR_LIBEXEC/hfaxd ]; then
cat<<EOF
Warning: $INETDCONF is setup wrong!
The $INETDCONF file is setup to start $F
instead of $DIR_LIBEXEC/hfaxd. You will need to correct
this before client requests to submit jobs will be properly serviced.
EOF
prompt "Should the entry in $INETDCONF be corrected [yes]?"; read x
isOK "$x" && editInetdConf
fi
if [ "$U" != $FAX ]; then
cat<<EOF
Warning: $INETDCONF is setup wrong!
Warning, the HylaFAX entry is setup so that $F is run by the
$U user instead of the $FAX user. This must be corrected
before client requests to submit jobs will be properly serviced.
EOF
prompt "Should the entry in $INETDCONF be corrected [yes]?"; read x
isOK "$x" && editInetdConf
fi
fi
elif [ ! -f $INETDCONF -a $HFAXD_SERVER -eq 0 ]; then
cat<<EOF
Warning: Don't know how to startup HylaFAX servers!
No $INETDCONF file was found and the System V boot script
that starts up the HylaFAX server processes was also not present.
You will need to manually arrange for the various HylaFAX servers
to be started up on your system when it is booted multi-user.
Specifically you will need to start the faxq and hfaxd programs and
any faxgetty processes that are to service inbound calls on modems.
EOF
fi
fi
#
# Check for a FaxMaster entry for sending mail.
#
if onServer; then
x=`(ypcat -k aliases) 2>/dev/null | $GREP -i '^faxmaster'`
2>/dev/null
if [ -z "$x" -a -f $ALIASES ]; then
x=`$GREP -i '^faxmaster' $ALIASES`
fi
if [ -z "$x" ]; then
cat<<-EOF
There does not appear to be an entry for the FaxMaster either in
the YP/NIS database or in the $ALIASES file. The
FaxMaster is the primary point of contact for HylaFAX problems.
The HylaFAX client-server protocol server identifies this alias as
the place to register complaints and HylaFAX directs automatic mail
messages to this user when problems are identified on a server
machine or when the routine server maintainence scripts are run
(e.g. faxcron).
EOF
prompt "Should an entry be added for the FaxMaster to $ALIASES
[yes]?"
read x
if isOK $x; then
promptForNonNullStringParameter "${USER:-root}" \
"Users to receive fax-related mail"
(echo "# alias for notification messages from HylaFAX servers";
echo "FaxMaster: $param") >>$ALIASES
if newaliases 2>/dev/null; then
echo "Rebuilt $ALIASES database."
else
# could be a SCO machine running mmdf
if test -x /usr/mmdf/table/dbmbuild ; then
su mmdf -c "/usr/mmdf/table/dbmbuild"
else
echo "Can not find newaliases to rebuild $ALIASES;"
echo "you will have to do it yourself."
fi
fi
fi
fi
fi
#
# Emit shell functions required by faxaddmodem.
#
if onServer; then
STTYCMD=`findApp stty $PATH`
(dumpTTYFuncs; dumpSTTYFuncs; dumpOtherModemFuncs)>&5
$RM etc/setup.modem
$MV etc/setup.tmp etc/setup.modem
$CHMOD 444 etc/setup.modem
$RM etc/setup.cache
(echo '# Warning, this file was automatically generated by
faxsetup'
echo '# on' `date` "for ${USER:-$euid}"
dumpvals |sort)> etc/setup.cache
$CHMOD 444 etc/setup.cache
Note ""
Note "Modem support functions written to
$DIR_SPOOL/etc/setup.modem."
Note "Configuration parameters written to
$DIR_SPOOL/etc/setup.cache."
fi
#
# Configuration parameters specific to scheduler operation.
# Required parameters are *always* emitted in the created
# configuration file; optional parameters are emitted
# only if the configured value differs from the default
# value known to be used by the server.
#
# NB: the order of some parameters is important; e.g.
# DialStringRules must be after AreaCode and CountryCode.
#
RequiredSchedulerParameters="
LogFacility
CountryCode
AreaCode
LongDistancePrefix
InternationalPrefix
DialStringRules
ServerTracing
"
OptionalSchedulerParameters="
ContCoverPage
ContCoverCmd
DestControls
MaxConcurrentJobs
MaxDials
MaxSendPages
MaxTries
ModemGroup
PostScriptTimeout
PS2FaxCmd
SendFaxCmd
SendPageCmd
SendUUCPCmd
SessionTracing
TimeOfDay
Use2D
"
#
# NB: these defaults are set above
#
OptionalParameters="
$OptionalSchedulerParameters
JobReqOther
NotifyCmd
UUCPLockDir
UUCPLockTimeout
UUCPLockType
"
SchedulerParameters="
$RequiredSchedulerParameters
$OptionalParameters
"
#
# Echo the configuration lines for those scheduler parameters
# whose value is different from the default value. Note
# that we handle the case where there is embedded whitespace
# by enclosing the parameter value in quotes.
#
echoSchedulerParameters()
{
(for i in $RequiredSchedulerParameters; do
eval echo \"$i:\$$i:\"
done
for i in $OptionalSchedulerParameters; do
eval echo \"$i:\$$i:\$default$i\"
done) | $AWK -F: '
function p(tag, value)
{
tabs = substr("\t\t\t", 1, 3-int((length(tag)+1)/8));
if (match(value, "^[^\"].*[ ]") == 0)
printf "%s:%s%s\n", tag, tabs, value
else
printf "%s:%s\"%s\"\n", tag, tabs, value
}
$2 != $3{ p($1, $2) }'
}
#
# Print the current server configuration parameters.
#
printSchedulerConfig()
{
(for i in $SchedulerParameters; do
eval echo \"$i:\$$i:\$default$i\"
done) | $AWK -F: '
function p(tag, value)
{
tabs = substr("\t\t\t", 1, 3-int((length(tag)+1)/8));
printf "%s:%s%s\n", tag, tabs, value
}
BEGIN { printf "\nThe non-default scheduler parameters are:\n\n" }
$2 != $3{ p($1, $2) }
END { printf "\n" }'
}
checkForLocalFile()
{
f="`echo $1 | $SED 's/\"//g'`"
if [ ! -f $DIR_SPOOL/$f ]; then
cat<<EOF
Warning, the $2 file,
$DIR_SPOOL/$f
does not exist, or is not a plain file. This file must
reside in the $DIR_SPOOL directory tree.
EOF
ok=no;
fi
}
isNotOK()
{
x="$1"
test "$x" != y -a "$x" != yes
}
CONFIG=$DIR_SPOOL/etc/config # faxq config file
if onServer; then
if [ ! -f $CONFIG ]; then
for i in $SchedulerParameters; do
eval $i=\$default$i
done
echo ""
echo "No scheduler config file exists, creating one from scratch."
ok=prompt # prompt for parameters
PROMPTS=/tmp/faxpr$$
JUNK="$JUNK $PROMPTS"
$RM $PROMPTS
while true; do
if [ "$ok" != skip ]; then
test -f $PROMPTS || compilePrompts>$PROMPTS<<EOF
# CountryCode Country code
# AreaCode Area code
# LongDistancePrefix Long distance dialing prefix
# InternationalPrefix International dialing prefix
NNS DialStringRules Dial string rules file (relative to $DIR_SPOOL)
C# ServerTracing Tracing during normal server operation
C# SessionTracing \
Default tracing during send and receive sessions
S ContCoverPage Continuation cover page (relative to $DIR_SPOOL)
C# PostScriptTimeout \
Timeout when converting PostScript documents (secs)
C# MaxConcurrentJobs \
Maximum number of concurrent jobs to a destination
S ModemGroup Define a group of modems
S TimeOfDay Time of day restrictions for outbound jobs
S DestControls \
Pathname of destination controls file (relative to $DIR_SPOOL)
C# UUCPLockTimeout \
Timeout before purging a stale UUCP lock file (secs)
C# MaxSendPages Max number of pages to permit in an outbound job
S LogFacility Syslog facility name for ServerTracing messages
EOF
. $PROMPTS
fi
checkForLocalFile $DialStringRules "dial string rules"
if [ "$DestControls" != "" -a "$DestControls" != '""' ]; then
checkForLocalFile $DestControls "destination controls";
fi
printSchedulerConfig; prompt "Are these ok [yes]?"; read ok
isOK "$ok" && break
done
#
# All done with the prompting; edit up a config file!
#
echo ""
echo "Creating new configuration file $CONFIG..."
echoSchedulerParameters >$CONFIG 2>/dev/null
test -s $CONFIG || {
JUNK="$JUNK $CONFIG" # clobber on exit
cat<<EOF
FATAL ERROR: Problem writing $CONFIG!
Sorry, something went wrong writing the new scheduler configuration
file. Check to make sure there is sufficient disk space and rerun
this script.
EOF
boom
}
$CHOWN $faxUID $CONFIG; $CHGRP $faxGID $CONFIG
$CHMOD 644 $CONFIG
fi
fi
#
# Startup/restart server processes.
#
if onServer; then
echo ""
echo "Restarting HylaFAX server processes."
findproc()
{
# NB: ps ax should give an error on System V, so we try it first!
pid="`ps ax 2>/dev/null | $AWK \"\
/[\/ (]$1[ )]/ {print \\$1;}
/[\/ ]$1\$/ {print \\$1;}\"`"
test "$pid" ||
pid="`ps -e 2>/dev/null | $AWK \"/ $1[ ]*\$/ {print \\$1;}\"`"
echo "$pid"
}
HFAXD="`findproc hfaxd`"
# if [ "$HFAXD" ]; then
# fi
FAXD="`findproc faxd`"
if [ "$FAXD" ]; then
echo ""
echo "You seem to be running FlexFAX (there are faxd processes)."
prompt "Is it ok to terminate these processes ($FAXD) [yes]?"; read x
if isOK "$x"; then
if kill $FAXD; then
echo "Sent a SIGTERM to processes $FAXD."
else
echo "Unable to send a SIGTERM to processes $FAXD."
fi
while true; do
for delay in 1 1 2 2 5 5; do
FAXD="`findproc faxd`"
test "$FAXD" || break
sleep $delay
done
test -z "$FAXD" && break
cat<<EOF
Warning: faxd is still running!
Something is hung. The command
kill $FAXD
did not terminate the faxd processes as expected.
EOF
prompt "Should we continue to wait [no]?"; read x
isNotOK "$x" && break
done
fi
fi
FAXQ="`findproc faxq`"
if [ "$FAXQ" ]; then
cat<<EOF
You have a HylaFAX scheduler process running. faxq will be
restarted shortly, as soon as some other work has been completed.
EOF
prompt "Can I terminate this faxq process ($FAXQ) [yes]?";
read x
if isOK "$x" ]; then
$DIR_SBIN/faxquit >/dev/null 2>&1
while true; do
for delay in 1 1 2 2 5 5; do
FAXQ="`findproc faxq`"
test "$FAXQ" || break
sleep $delay
done
test -z "$FAXQ" && break
pids=
for p in faxsend pagesend; do
pids="${pids}`findproc $p`"
done
if [ "$pids" ]; then
cat<<EOF
Warning: faxq is busy with outbound jobs!
faxq did not terminate in response to the faxquit command because
there are subprocesses actively processing outbound jobs.
EOF
prompt "Should we continue to wait [yes]?"; read x
isOK "$x" || break
else
cat<<EOF
Warning: faxq is still running for some reason!
Something is hung, faxq did not terminate in response to the faxquit
command. There do not appear to be any faxsend or pagesend
subprocesses
actively handling outbound jobs so the reason for it running is
unknown.
EOF
prompt "Should we continue to wait [no]?"; read x
isNotOK "$x" && break
fi
done
fi
fi
if [ "$FAXQ" -o "$FAXD" ]; then
cat<<EOF
FATAL ERROR: Old server processes still running!
One or more old server processes are still running. It is not wise
to start new server processes while old processes are running because
their actions might conflict. You need to terminate the existing
processes and rerun this script or manually startup the new HylaFAX
server processes.
EOF
boom
fi
if [ "$signalINETD" = yes ]; then
INETD="`findproc inetd`"
if [ "$INETD" ]; then
if kill -HUP $INETD 2>/dev/null; then
echo "Sent inetd a SIGHUP so that it re-reads the configuration
file."
else
echo "Unable to send inetd a SIGHUP, you may need to do it
yourself."
fi
else
echo "Strange, you do not seem to have an inetd process running."
fi
fi
prompt "Should I restart the HylaFAX server processes [yes]?";
read x
if isOK "$x"; then
echo ""
if [ -x $SYSVINIT ]; then
echo $SYSVINIT start
$SYSVINIT start
else
echo $DIR_SBIN/faxq; $DIR_SBIN/faxq
fi
fi
DEVS="`cd $DIR_SPOOL/etc; echo config.*`"
if [ -z "$DEVS" -o "$DEVS" = 'config.*' ]; then
cat<<EOF
You do not appear to have any modems configured for use. Modems are
configured for use with HylaFAX with the faxaddmodem(1M) command.
EOF
prompt "Do you want to run faxaddmodem to configure a modem [yes]?";
read x
while isOK "$x"; do
$DIR_SBIN/faxaddmodem
prompt "Do you want to run faxaddmodem to configure another
modem [yes]?"; read x
done
DEVS="`cd $DIR_SPOOL/etc; echo config.*`"
fi
if [ -n "$DEVS" -a "$DEVS" != 'config.*' ]; then
FAXGETTY="`findproc faxgetty`"
if [ "$FAXGETTY" ]; then
cat<<EOF
Looks like you have some faxgetty processes running (PIDs are):
$FAXGETTY
It is usually a good idea to restart these processes after running
faxsetup; especially if have just installed new software. If these
processes are being started by init(1M) then sending each of them a
QUIT message with the faxquit command should cause them to be
restarted.
EOF
prompt "Is it ok to send a QUIT command to each process [yes]?"
read x
if isOK "$x"; then
for x in $DEVS; do
devid="`expr $x : 'config.\(.*\)'`"
if [ -w $DIR_SPOOL/FIFO.$devid ]; then
echo $DIR_SBIN/faxquit $devid
$DIR_SBIN/faxquit $devid >/dev/null 2>&1
fi
done
fi
else
if [ -f /etc/inittab ]; then
FAXGETTY="`$GREP '[^#].*:respawn:faxgetty.*' /etc/inittab`"
elif [ -f /etc/ttys ]; then
FAXGETTY="`$GREP '[^#].*faxgetty.*' /etc/ttys`"
fi
if [ "$FAXGETTY" ]; then
cat<<EOF
You appear to have faxgetty setup to run on some tty lines but no
faxgetty
processes were found running. This might happen if you manually
edited the
tty configuration file but did not notify init to re-read the file.
EOF
prompt "Send init a SIGHUP so that it re-reads its configuration
file [yes]?"
read x
if isOK "$x"; then
init="`findproc init`"
if [ "$init" ]; then
if kill -HUP $init; then
echo "Sent init a SIGHUP; the faxgetty processes should be
started."
else
echo "Unable to send init a SIGHUP; you may need to do this
yourself."
fi
else
echo "Strange, you do not seem to have an init process running!"
fi
fi
else
cat<<EOF
You do not appear to be using faxgetty to notify the HylaFAX scheduler
about new modems and/or their status. This means that you must use
the
faxmodem program to inform the new faxq process about the modems you
want to have scheduled by HylaFAX. Beware that if you have modems
that
require non-default capabilities specified to faxmodem then you should
read faxmodem(1M) manual page and do this work yourself (since this
script is not intelligent enough to automatically figure out the modem
capabilities and supply the appropriate arguments).
EOF
prompt "Should I run faxmodem for each configured modem [yes]?"
read x
if isOK "$x"; then
for x in $DEVS; do
devid="`expr $x : 'config.\(.*\)'`"
if [ -w $DIR_SPOOL/FIFO.$devid ]; then
echo $DIR_SBIN/faxmodem $devid
$DIR_SBIN/faxmodem $devid >/dev/null 2>&1
fi
done
fi
fi
fi
fi
fi
Note ""
Note "Done verifying system setup."
if onServer; then
$RM $JUNK
fi
exit 0
/Bofcusm/2190.html copyright 1997-2004 (various authors) All Rights Reserved
Have you tried Searching this site?
Unix/Linux/Mac OS X support by phone, email or on-site: Support Rates
This is a Unix/Linux resource website. It contains technical articles about Unix, Linux and general computing related subjects, opinion, news, help files, how-to's, tutorials and more. We appreciate comments and article submissions.
Many of the products and books I review are things I purchased for my own use. Some were given to me specifically for the purpose of reviewing them. I resell or can earn commissions from the sale of some of these items. Links within these pages may be affiliate links that pay me for referring you to them. That's mostly insignificant amounts of money; whenever it is not I have made my relationship plain. I also may own stock in companies mentioned here. If you have any question, please do feel free to contact me.
Specific links that take you to pages that allow you to purchase the item I reviewed are very likely to pay me a commission. Many of the books I review were given to me by the publishers specifically for the purpose of writing a review. These gifts and referral fees do not affect my opinions; I often give bad reviews anyway.
We use Google third-party advertising companies to serve ads when you visit our website. These companies may use information (not including your name, address, email address, or telephone number) about your visits to this and other websites in order to provide advertisements about goods and services of interest to you. If you would like more information about this practice and to know your choices about not having this information used by these companies, click here.
Click here to add your comments
Don't miss responses! Subscribe to Comments by RSS or by Email
Click here to add your comments
If you want a picture to show with your comment, go get a Gravatar