Annotation of 43BSDReno/usr.bin/uucp/uux.0, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: 
                      4: UUX(1)                       1988                         UUX(1)
                      5: 
                      6: 
                      7: 
                      8: NNAAMMEE
                      9:      uux - unix to unix command execution
                     10: 
                     11: SSYYNNOOPPSSIISS
                     12:      uuuuxx [ -- ] [ --ccCCllLLnnpprrzz ] [ --aa_n_a_m_e ] [ --gg_g_r_a_d_e ] [ --xx_d_e_b_u_g ]
                     13:      command-string
                     14: 
                     15: DDEESSCCRRIIPPTTIIOONN
                     16:      _U_u_x will gather zero or more files from various systems,
                     17:      execute a command on a specified system and then send stan-
                     18:      dard output to a file on a specified system.
                     19: 
                     20:      The _c_o_m_m_a_n_d-_s_t_r_i_n_g is made up of one or more arguments that
                     21:      look like a Shell command line, except that the command and
                     22:      file names may be prefixed by _s_y_s_t_e_m-_n_a_m_e!!.  A null _s_y_s_t_e_m-
                     23:      _n_a_m_e is interpreted as the local system.
                     24: 
                     25:      File names may be one of
                     26: 
                     27:          (1) a full path name;
                     28: 
                     29:          (2) a path name preceded by ~~_u_s_e_r where _u_s_e_r is a login
                     30:          name on the specified system and is replaced by that
                     31:          user's login directory;
                     32: 
                     33:          (3) a path name prefixed by ~~;; where ~~ is expanded to
                     34:          the system's public directory (usually
                     35:          /var/spool/uucppublic);
                     36: 
                     37:          (4) a partial pathname, which is prefixed by the
                     38:          current directory.
                     39: 
                     40:      As an example, the command
                     41: 
                     42:          uux "!diff usg!/usr/dan/file1 pwba!/a4/dan/file2 >
                     43:          !~/dan/file.diff"
                     44: 
                     45:      will get the ffiillee11 and ffiillee22 files from the ``usg'' and
                     46:      ``pwba'' machines, execute a _d_i_f_f(1) command and put the
                     47:      results in ffiillee..ddiiffff in the local /var/spool/uucppublic/dan/
                     48:      directory.
                     49: 
                     50:      Any special shell characters, such as <<>>;;||, should be quoted
                     51:      either by quoting the entire _c_o_m_m_a_n_d-_s_t_r_i_n_g, or quoting the
                     52:      special characters as individual arguments.
                     53: 
                     54:      _U_u_x will attempt to get all files to the execution system.
                     55:      For files that are output files, the file name must be
                     56:      escaped using parentheses.  For example, the command
                     57: 
                     58:          uux a!wc b!/usr/file1 \(c!/usr/file2 \)
                     59: 
                     60: 
                     61: 
                     62: 
                     63: Printed 7/4/90              October                            1
                     64: 
                     65: 
                     66: 
                     67: 
                     68: 
                     69: 
                     70: UUX(1)                       1988                         UUX(1)
                     71: 
                     72: 
                     73: 
                     74:      get //uussrr//ffiillee11 from system ``b'' and send it to system
                     75:      ``a'', perform a _w_c command on that file and send the result
                     76:      of the _w_c command to system ``c''.
                     77: 
                     78:      _U_u_x will notify you by mail if the requested command on the
                     79:      remote system was disallowed.  This notification can be
                     80:      turned off by the --nn option.
                     81: 
                     82:      The following _o_p_t_i_o_n_s are interpreted by _u_u_x:
                     83: 
                     84:      --         The standard input to _u_u_x is made the standard input to
                     85:          the _c_o_m_m_a_n_d-_s_t_r_i_n_g.
                     86: 
                     87:      --aa_n_a_m_e
                     88:          Use _n_a_m_e as the user identification replacing the ini-
                     89:          tiator user-id.
                     90: 
                     91:      --cc   Do not copy local file to the spool directory for
                     92:          transfer to the remote machine (this is the default).
                     93: 
                     94:      --CC   Force the copy of local files to the spool directory
                     95:          for transfer.
                     96: 
                     97:      --gg_g_r_a_d_e
                     98:          _G_r_a_d_e is a single letter/number, from 00 to 99, AA to ZZ,
                     99:          or aa to zz; 00 is the highest, and zz is the lowest grade.
                    100:          The default is AA; by comparison _u_u_c_p(1) defaults to nn
                    101:          and mail is usually sent at grade CC.        Lower grades
                    102:          should be specified for high-volume jobs, such as news.
                    103: 
                    104:      --ll   Try and make a link from the original file to the spool
                    105:          directory.  If the link cannot be made, copy the file.
                    106: 
                    107:      --nn   Do not notify the user when the command completes.
                    108: 
                    109:      --pp   Same as -: The standard input to _u_u_x is made the stan-
                    110:          dard input to the _c_o_m_m_a_n_d-_s_t_r_i_n_g.
                    111: 
                    112:      --rr   Do not start the file transfer, just queue the job.
                    113: 
                    114:      --xx_d_e_b_u_g
                    115:          Produce debugging output on stdout.  The debug is a
                    116:          number between 0 and 9; higher numbers give more
                    117:          detailed information. Debugging is permitted only for
                    118:          privileged users (specifically, those with read access
                    119:          to _L._s_y_s(5).
                    120: 
                    121:      --zz   Notify the user only if the command fails.
                    122: 
                    123:      --LL   Start up _u_u_c_i_c_o with the --LL flag. This will force calls
                    124:          to be made to local sites only (see _u_u_c_i_c_o(8)).
                    125: 
                    126: 
                    127: 
                    128: 
                    129: Printed 7/4/90              October                            2
                    130: 
                    131: 
                    132: 
                    133: 
                    134: 
                    135: 
                    136: UUX(1)                       1988                         UUX(1)
                    137: 
                    138: 
                    139: 
                    140: FFIILLEESS
                    141:      /var/spool/uucp      spool directories
                    142:      /usr/lib/uucp/*      UUCP configuration data and daemons
                    143: 
                    144: SSEEEE AALLSSOO
                    145:      uucp(1), uucico(8), uuxqt(8).
                    146: 
                    147: WWAARRNNIINNGG
                    148:      For security reasons, many installations will limit the list
                    149:      of commands executable on behalf of an incoming request from
                    150:      _u_u_x.  Many sites will permit little more than the receipt of
                    151:      mail (see _m_a_i_l(1)) via _u_u_x.
                    152: 
                    153: BBUUGGSS
                    154:      Only the first command of a shell pipeline may have a
                    155:      _s_y_s_t_e_m-_n_a_m_e!!.  All other commands are executed on the system
                    156:      of the first command.
                    157: 
                    158:      The use of the shell metacharacter ** will probably not do
                    159:      what you want it to do.
                    160: 
                    161:      The shell tokens <<<< and >>>> are not implemented.
                    162: 
                    163:      When invoking _u_u_x from _c_s_h(1), the `!' character must be
                    164:      prefixed by the `\' escape to inhibit _c_s_h's history mechan-
                    165:      ism. (Quotes are not sufficient.)
                    166: 
                    167: 
                    168: 
                    169: 
                    170: 
                    171: 
                    172: 
                    173: 
                    174: 
                    175: 
                    176: 
                    177: 
                    178: 
                    179: 
                    180: 
                    181: 
                    182: 
                    183: 
                    184: 
                    185: 
                    186: 
                    187: 
                    188: 
                    189: 
                    190: 
                    191: 
                    192: 
                    193: 
                    194: 
                    195: Printed 7/4/90              October                            3
                    196: 
                    197: 
                    198: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.