Provided by: hylafax-server_6.0.5-5ubuntu3_i386 bug

NAME

       faxsetup - setup a machine for use with HylaFAX

SYNOPSIS

       /usr/sbin/faxsetup [ -client ] [ -server ] [ -with-VAR[=value] ]

DESCRIPTION

       faxsetup  is  an interactive shell script that does the necessary setup
       work to configure a client or server machine for the HylaFAX  software.
       faxsetup  must  be  run  on  every  HylaFAX  server  machine before the
       software will function-if a HylaFAX server program or script is invoked
       before faxsetup is run, the command will abort with a message that says
       to run faxsetup.  faxsetup may optionally be run on  a  HylaFAX  client
       machine to verify the configuration of the software.

       By  default  faxsetup checks a machine for use both as a HylaFAX client
       and server.  Client-specific checks include:

       o  the installation of client programs and data,

       o  the installation of the Adobe Font Metric  (AFM)  information  files
          used by the HylaFAX text formatting support.

       Server-specific checks include:

       o  the installation of server programs and data,

       o  the existence of the UUCP lock file directory,

       o  the installation of the TIFF software tools,

       o  the  configuration  of the getty programs invoked for data and voice
          calls,

       o  the pathnames for various  system  programs  used  by  server  shell
          scripts,

       o  proper support for FIFO special files,

       o  proper installation of a POSTSCRIPT RIP,

       o  definition of a ``fax'' user,

       o  definitions for the ``hylafax'' and ``snpp'' services,

       o  startup of the HylaFAX server processes: faxq(8) and hfaxd(8),

       o  definition  of  a  ``FaxMaster''  mail  alias  for  reporting server
          problems.

       For server machines faxsetup also creates two files that  are  required
       by the HylaFAX command scripts.  One file contains master configuration
       parameters and the other contains various definitions used  by  scripts
       such as faxaddmodem(8) that communicate with modems.

OPTIONS

       -client   Do client-specific consistency checks.

       -server   Do server-specific consistency checks.

       -with-VAR[=value]
                 Override   the   default  definition  for  the  configuration
                 parameter named VAR; optionally specifying a new value (if no
                 value  is  specified  then  ``yes'' is used).  This option is
                 especially useful to override the default  settings  for  the
                 POSTSCRIPT   interpreter   package   to  use  (e.g.  ``-with-
                 PS=dps''),     the     spooling      directory      (``-with-
                 DIR_SPOOL=/mumble''),    the   directory   where   the   tool
                 applications  of  TIFF  software  distribution  are   located
                 (``-with-TIFFBIN=/usr/freeware''),  etc.   A complete list of
                 the possible parameters  can  be  found  by  looking  at  the
                 contents   of  the  faxsetup  shell  script;  many  of  these
                 configuration parameters are also  described  in  the  online
                 documentation

       -help     Print a help message and terminate.

       -quiet    Do not print verbose messages to the terminal.

       -verbose  Print informative messages to the terminal (default).

BUGS

       faxsetup  does  not  query  a  modem  to find out its capabilities when
       invoking the  faxmodem  program  to  setup  a  server  in  a  send-only
       configuration; it may be necessary to run faxmodem manually.

FILES

       /var/spool/hylafax/etc/setup.cache    master configuration parameters
       /var/spool/hylafax/etc/setup.modem    modem-related configuration support

       Consult  hylafax-server(5)  for  a complete discussion of the structure
       and content of the spooling area.

SEE ALSO

       hylafax-server(5),     hylafax-config(5),     faxq(8),     faxgetty(8),
       faxmodem(8), faxconfig(8), faxsend(8)

                                August 26, 1996                    FAXSETUP(8)