home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / uucp / wUUCP_0.0.23.lha / man / uux.man < prev    next >
Encoding:
Text File  |  1993-02-19  |  8.7 KB  |  265 lines
  1.  
  2.  
  3.  
  4. uux(1)                                                     uux(1)
  5.  
  6.  
  7. ¢1mNAME¢22m
  8.        uux - Remote command execution over UUCP
  9.  
  10. ¢1mSYNOPSIS¢22m
  11.        ¢1muux¢22m [ options ] command
  12.  
  13. ¢1mDESCRIPTION¢22m
  14.        The  ¢4muux¢24m  command is used to execute a command on a remote
  15.        system, or to execute a command on the local system  using
  16.        files  from  remote  systems.  The command is not executed
  17.        immediately; the request is queued until  the  ¢4muucico¢24m  (8)
  18.        daemon  calls  the  system and executes it.  The daemon is
  19.        started automatically unless the ¢1m-r¢22m switch is given.
  20.  
  21.        The actual command execution is done by the ¢4muuxqt¢24m (8) dae¡
  22.        mon.
  23.  
  24.        File  arguments can be gathered from remote systems to the
  25.        execution system, as can standard input.  Standard  output
  26.        may be directed to a file on a remote system.
  27.  
  28.        The command name may be preceded by a system name followed
  29.        by an exclamation point if it  is  to  be  executed  on  a
  30.        remote system.  An empty system name is taken as the local
  31.        system.
  32.  
  33.        Each  argument  that  contains  an  exclamation  point  is
  34.        treated as naming a file.  The system which the file is on
  35.        is before the exclamation point, and the pathname on  that
  36.        system  follows  it.  An empty system name is taken as the
  37.        local system; this must be used to transfer a  file  to  a
  38.        command being executed on a remote system.  If the path is
  39.        not absolute, it will be appended to the  current  working
  40.        directory on the local system; the result may not be mean¡
  41.        ingful on the remote system.  A pathname  may  begin  with
  42.        ~/, in which case it is relative to the UUCP public direc¡
  43.        tory (usually /usr/spool/uucppublic)  on  the  appropriate
  44.        system.   A  pathname may begin with ~name/, in which case
  45.        it is relative to the home directory of the named user  on
  46.        the appropriate system.
  47.  
  48.        Standard  input and output may be redirected as usual; the
  49.        pathnames used may contain exclamation points to  indicate
  50.        that  they  are on remote systems.  Note that the redirec¡
  51.        tion characters must be quoted so that they are passed  to
  52.        ¢4muux¢24m rather than interpreted by the shell.  Append redirec¡
  53.        tion (>>) does not work.
  54.  
  55.        All specified files are gathered together  into  a  single
  56.        directory  before  execution  of the command begins.  This
  57.        means that each file must have a distinct base name.   For
  58.        example,  uux  'sys1!diff  sys2!~user1/foo sys3!~user2/foo
  59.        >!foo.diff' will fail because both files will be copied to
  60.        sys1 and stored under the name foo.
  61.  
  62.  
  63.  
  64.                          Taylor UUCP 1.03                       1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. uux(1)                                                     uux(1)
  71.  
  72.  
  73.        Arguments  may be quoted by parentheses to avoid interpre¡
  74.        tation of exclamation points.  This is useful when execut¡
  75.        ing the ¢4muucp¢24m command on a remote system.
  76.  
  77. ¢1mOPTIONS¢22m
  78.        The following options may be given to ¢4muux.¢24m
  79.  
  80.        ¢1m-,-p¢22m Read  standard input and use it as the standard input
  81.             for the command to be executed.
  82.  
  83.        ¢1m-c¢22m   Do not copy local files to the spool directory.  This
  84.             is  the  default.   If  they are removed before being
  85.             processed by the ¢4muucico¢24m (8)  daemon,  the  copy  will
  86.             fail.   The  files must be readable by the ¢4muucico¢24m (8)
  87.             daemon, as well as the by the invoker of ¢4muux.¢24m
  88.  
  89.        ¢1m-C¢22m   Copy local files to the spool directory.
  90.  
  91.        ¢1m-l¢22m   Link local files into the spool directory.  If a file
  92.             can  not  be  linked  because  it  is  on a different
  93.             device, it will be copied unless the ¢1m-c¢22m  option  also
  94.             appears  (in  other  words,  use  of  ¢1m-l¢22m switches the
  95.             default from ¢1m-c¢22m to ¢1m-C).¢22m  If  the  files  are  changed
  96.             before  being processed by the ¢4muucico¢24m (8) daemon, the
  97.             changed versions will be used.   The  files  must  be
  98.             readable  by the ¢4muucico¢24m (8) daemon, as well as by the
  99.             invoker of ¢4muux.¢24m
  100.  
  101.        ¢1m-g¢22m ¢1mgrade¢22m
  102.             Set the grade of the file transfer command.  Jobs  of
  103.             a  higher grade are executed first.  Grades run 0 ...
  104.             9 A ... Z a ... z from high to low.
  105.  
  106.        ¢1m-n¢22m   Do not send mail about the status of the job, even if
  107.             it fails.
  108.  
  109.        ¢1m-z¢22m   Send  mail  about  the  status of the job if an error
  110.             occurs.  For many ¢4muuxqt¢24m daemons, including the Taylor
  111.             UUCP ¢4muuxqt,¢24m this is the default action; for those, ¢1m-z¢22m
  112.             will have no effect.   However,  some  ¢4muuxqt¢24m  daemons
  113.             will  send  mail  if  the  job succeeds unless the ¢1m-z¢22m
  114.             option is used, and some other ¢4muuxqt¢24m daemons will not
  115.             send  mail  if  the job fails unless the ¢1m-z¢22m option is
  116.             used.
  117.  
  118.        ¢1m-r¢22m   Do not  start  the  ¢4muucico¢24m  (8)  daemon  immediately;
  119.             merely  queue up the execution request for later pro¡
  120.             cessing.
  121.  
  122.        ¢1m-j¢22m   Print jobids on standard output.   A  jobid  will  be
  123.             generated  for  each  file copy operation required to
  124.             perform the operation.  These file copies may be can¡
  125.             celled  by passing the jobid to the ¢1m-k¢22m switch of ¢4muus¡¢24m
  126.             ¢4mtat¢24m (1), which will make the execution impossible  to
  127.  
  128.  
  129.  
  130.                          Taylor UUCP 1.03                       2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. uux(1)                                                     uux(1)
  137.  
  138.  
  139.             complete.
  140.  
  141.        ¢1m-a¢22m ¢1maddress¢22m
  142.             Report job status to the specified e¡mail address.
  143.  
  144.        ¢1m-x¢22m ¢1mtype¢22m
  145.             Turn  on  particular  debugging types.  The following
  146.             types  are  recognized:  abnormal,  chat,  handshake,
  147.             uucp¡proto,  proto,  port, config, spooldir, execute,
  148.             incoming, outgoing.  Only abnormal, config,  spooldir
  149.             and execute are meaningful for ¢4muux.¢24m
  150.  
  151.             Multiple types may be given, separated by commas, and
  152.             the ¢1m-x¢22m option may appear multiple  times.   A  number
  153.             may also be given, which will turn on that many types
  154.             from the foregoing list; for example, ¢1m-x¢22m ¢1m2¢22m is equiva¡
  155.             lent to ¢1m-x¢22m ¢1mabnormal,chat.¢22m
  156.  
  157.        ¢1m-I¢22m ¢1mfile¢22m
  158.             Set  configuration  file to use.  This option may not
  159.             be available, depending upon how ¢4muux¢24m was compiled.
  160.  
  161. ¢1mEXAMPLES¢22m
  162.        uux ¡z ¡ sys1!rmail  user1  Execute  the  command  ``rmail
  163.        user1''  on  the  system sys1, giving it as standard input
  164.        whatever is given to ¢4muux¢24m as standard input.  If a  failure
  165.        occurs,  send  a  message  using  ¢4mmail¢24m  (1).  uux 'diff ¡c
  166.        sys1!~user1/file1 sys2!~user2/file2 >!file.diff' Fetch the
  167.        two  named files from system sys1 and system sys2 and exe¡
  168.        cute ¢4mdiff¢24m putting the result in file.diff in  the  current
  169.        directory.   The current directory must be writable by the
  170.        ¢4muuxqt¢24m  (8)  daemon  for  this  to  work.   uux  'sys1!uucp
  171.        ~user1/file1 (sys2!~user2/file2)' Execute ¢4muucp¢24m on the sys¡
  172.        tem sys1 copying file1 (on system  sys1)  to  sys2.   This
  173.        illustrates the use of parentheses for quoting.
  174.  
  175. ¢1mRESTRICTIONS¢22m
  176.        The  remote  system  may not permit you to execute certain
  177.        commands.  Many remote systems only permit  the  execution
  178.        of ¢4mrmail¢24m and ¢4mrnews.¢24m
  179.  
  180.        Some  of  the options are dependent on the capabilities of
  181.        the ¢4muuxqt¢24m (8) daemon on the remote system.
  182.  
  183. ¢1mFILES¢22m
  184.        The file names may be changed at compilation  time  or  by
  185.        the  configuration file, so these are only approximations.
  186.  
  187.        /usr/lib/uucp/config ¡ Configuration file.
  188.        /usr/spool/uucp ¡ UUCP spool directory.
  189.        /usr/spool/uucp/Log ¡ UUCP log file.
  190.        /usr/spool/uucppublic ¡ Default UUCP public directory.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                          Taylor UUCP 1.03                       3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. uux(1)                                                     uux(1)
  203.  
  204.  
  205. ¢1mSEE¢22m ¢1mALSO¢22m
  206.        mail(1), uustat(1), uucp(1), uucico(8), uuxqt(8)
  207.  
  208. ¢1mBUGS¢22m
  209.        Files can not be referenced across multiple systems.
  210.  
  211.        Too many jobids are output by ¢1m-j,¢22m and there is no good way
  212.        to cancel a local execution requiring remote files.
  213.  
  214. ¢1mAUTHOR¢22m
  215.        Ian Lance Taylor (ian@airs.com or uunet!airs!ian)
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                          Taylor UUCP 1.03                       4
  263.  
  264.  
  265.