Annotation of 43BSDReno/usr.bin/uucp/uux.0, revision 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.