


MKUUWHO(8)                                             MKUUWHO(8)


NNAAMMEE
       mkuuwho - make a database suitable for the uuwho command

SSYYNNOOPPSSIISS
       //uussrr//lliibb//mmaaiill//mmkkuuuuwwhhoo [--vv] [--xx] [--ee] [--nn] [ --tt _t_r_a_c_e [ --uu
       _u_u_w_h_o___d_a_t_a_b_a_s_e ] [ _p_a_t_h___c_o_n_f_i_g ]

DDEESSCCRRIIPPTTIIOONN
       _M_k_u_u_w_h_o is a modified version of  the  _m_k_p_a_t_h(8)  utility,
       used  for creating a database for use by the _u_u_w_h_o(1) com-
       mand.  It reads a _m_k_p_a_t_h(8) configuration file and  builds
       a DBM database named _u_u_w_h_o___d_a_t_a_b_a_s_e (by default a database
       named _/_u_s_r_/_l_i_b_/_m_a_i_l_/_u_u_w_h_o).  This database is used by  the
       _u_u_w_h_o  command  to determine where maps for specific sites
       or domains can be found.  The configuration file  is  used
       to  determine  from  which  files, and in which order, map
       data should be used to create  this  DBM  database.   This
       command  is currently available only on machines that have
       the _d_b_m(3X) library functions.

       If _p_a_t_h___c_o_n_f_i_g is --, then a specification  will  be  taken
       from  the standard input.  If _p_a_t_h___c_o_n_f_i_g is omitted, then
       the default  specification  _/_u_s_r_/_l_i_b_/_m_a_i_l_/_m_a_p_s_/_m_k_p_a_t_h_._c_o_n_f
       is used.

CCOONNFFIIGGUURRAATTIIOONN FFIILLEE FFOORRMMAATT
       The  format  of  the  path  configuration file is a set of
       lines containing directives.  Blank lines are ignored  and
       the character ``#'' begins a comment which continues until
       the end of the line.  The various possible directives  are
       described below.

       In these directive descriptions, an argument of _a_r_g refers
       to one of the following types of arguments:

       '_l_i_t_e_r_a_l'        Literal data specified  inline.   (single
                        quotes)

       `_s_h_e_l_l_-_c_o_m_m_a_n_d`  Take  data  from  the  standard output of
                        this shell command.  (back quotes)

       _f_i_l_e_n_a_m_e _._._.     Take data from the named file  or  files.
                        Files  may be specified using shell glob-
                        bing notation, with ** ??  and [[]].

       The `_s_h_e_l_l_-_c_o_m_m_a_n_d` form preserves newlines and whitespace
       and  is  thus  not  entirely equivalent to usage in _s_h(1).
       The following lines result in the same input to _u_u_w_h_o_:

            map   `cat food`    # ackpft!
            map   food          # oop ack!

       For the `_s_h_e_l_l_-_c_o_m_m_a_n_d` and '_l_i_t_e_r_a_l' forms, the  filename
       used for error messages is _[_s_t_d_i_n_].



Local                    31 January 1988                        1





MKUUWHO(8)                                             MKUUWHO(8)


       mmaapp _a_r_g
              Specify  map  data  to  be given as input to uuwho.
              Each file is preceded by a line containing:

                   file { _p_a_t_h_n_a_m_e }

              where _p_a_t_h_n_a_m_e is the full pathname  to  the  file.
              This  allows uuwho to know which from file the data
              was taken.

       ssaaffeemmaapp   _a_r_g
              This is similar to the mmaapp directive,  and  can  be
              used  when  you do not have sufficient control over
              what the files contain.  If  a  map  file  contains
              pathalias  ffiillee  directives,  those  directives are
              ignored.

       ddeelleettee _a_r_g
       aaddjjuusstt _a_r_g
       ddeeaadd _a_r_g
       tteexxtt _a_r_g
       ffiillee _f_i_l_e_n_a_m_e
              These  _m_k_p_a_t_h  configuration  file  directives  are
              ignored by _m_k_u_u_w_h_o.

       ccdd [ _d_i_r ]
              By  default,  the current directory used by _m_k_u_u_w_h_o
              begins in the directory of the configuration  file,
              or in the current directory if the configuration is
              read from the standard input.  The ccdd command with-
              out  a  _d_i_r  argument changes to the directory from
              which _m_k_u_u_w_h_o was invoked.  A _d_i_r arg of --  changes
              the directory to the default directory based on the
              name of the  configuration  file.   Otherwise,  _d_i_r
              becomes  the  current  directory for file and shell
              command references.

       sshh _c_m_d The given shell command is executed.

       ppaatthhaalliiaass [ _f_l_a_g_s ]
       ppaatthhssoorrtt [ _f_l_a_g_s ]
              These directives end execution blocks (see the next
              section),  but have no other side effects when pro-
              cessed by _m_k_u_u_w_h_o.

EEXXEECCUUTTIIOONN BBLLOOCCKKSS
       Directives  are  executed  in  blocks.   A  mmaapp,  ssaaffeemmaapp,
       ddeelleettee,  aaddjjuusstt,  ddeeaadd  or  ffiillee directive starts a block.
       Successive directives continue it.  A ppaatthhaalliiaass  or  ppaatthh--
       ssoorrtt  directive ends a block.  The end of a file can end a
       block.

       When the start of a block is seen, all  directives  up  to
       the  end  of  the  block  are  collected  and fed into the



Local                    31 January 1988                        2





MKUUWHO(8)                                             MKUUWHO(8)


       resulting _u_u_w_h_o(8) command.  Directives such as ccdd  or  sshh
       within  a  block  only effect that block.  Therefore, a ccdd
       directive within a block will only  change  the  directory
       for  the  remainder  of that block, whereas a ccdd directive
       outside of a block has a global effect.

       Additionally an sshh directive will feed its standard output
       into  the  block's  pathalias  command when it is inside a
       block, while an sshh directive outside of a block will  send
       its  output  direct  to the standard output of the _m_k_u_u_w_h_o
       command.

OOPPTTIIOONNSS
       The following options are recognized by _m_k_u_u_w_h_o:

       --vv     The internal _s_h(1) commands are executed with a  --vv
              option, thus echoing the commands that are piped to
              the shell prior to their being processed.

       --xx     Pass the --xx flag to invocations of the shell, caus-
              ing  commands  which  are  about  to  execute to be
              echoed.

       --ee     Pass the --ee flag to invocations of the shell, caus-
              ing  shells  to  exit  whenever a command returns a
              non-zero exit status.   In  addition,  the  _m_k_u_u_w_h_o
              program will exit when it encounters a syntax error
              or unknown directive.

       --nn     Disable the execution of any  shell  commands  that
              _m_k_u_u_w_h_o  generates.   This  is  useful  with the --vv
              option and disables the --xx, --ee and --VV options.

       --tt _t_r_a_c_e
              Cause the input to pathalias to be copied into  the
              file _t_r_a_c_e.

       --uu _u_u_w_h_o___d_a_t_a_b_a_s_e
              Cause  the named DBM database to be created, rather
              than using the default name of _/_u_s_r_/_l_i_b_/_m_a_i_l_/_u_u_w_h_o.

SSEEEE AALLSSOO
       _m_k_p_a_t_h(8), _u_u_w_h_o(1), _d_b_m(3X) and _s_h(1).

BBUUGGSS
       The  first  ``#''  character  on  a  line begins a comment
       regardless of whether or not it is within quotes.

       The --ee option does not stop all  execution,  only  command
       execution  within an instance of the shell created by _m_k_u_-
       _u_w_h_o.

       Continuation lines are not currently allowed in  the  con-
       figuration file.  Each command must be on a single line.



Local                    31 January 1988                        3





MKUUWHO(8)                                             MKUUWHO(8)


CCOOPPYYRRIIGGHHTT
       Copyright(C)1987, 1988 Ronald S. Karr and Landon Curt Noll
       Copyright(C)1992 Ronald S. Karr
       See a file COPYING, distributed with the source  code,  or
       type  _s_m_a_i_l  _-_b_c  for distribution rights and restrictions
       associated with this software.



















































Local                    31 January 1988                        4


