2.9BSD/usr/man/cat1/net.1
NET(1) UNIX Programmer's Manual NET(1)
NAME
net - execute a command on a remote machine
SYNOPSIS
net [ -m machine ] [ -l login ] [ -p password ] [ -r
respfile ] [ - ] [ -f ] [ -n ] command
DESCRIPTION
The _n_e_t command sends the specified _c_o_m_m_a_n_d (which should be
enclosed in quotes) over the network to the specified (or
default) remote machine. The network will notify the user
when the command has been executed by `writing' (see
_w_r_i_t_e(1)) to the terminal if the user is still logged in, or
`mailing' (see _m_a_i_l(1)) otherwise.
There are a number of options, which must precede the com-
mand. Options may be specified on the command line, preced-
ing the command, or in a file ``.netrc'' in the user's login
directory. The ``.netrc'' file is not described here. The
-m option specifies the desired remote machine. If a remote
machine is not specified, the default one is used. The
machine name may be a one letter abbreviation or a full
name; upper- and lower-case distinctions are ignored. If
the standard output and standard error files are to be
saved, the -r option returns to the originating user a file
(_r_e_s_p_f_i_l_e) containing the standard output and error files
when the command was executed on the remote machine. If
this option is used, no message is written back. The pres-
ence of a non-zero length _r_e_s_p_f_i_l_e indicates completion.
The -n option suppresses all acknowledgements, including
error messages.
If the -l and -p options are not specified, and the login
name and password are not in the ``.netrc'' file, a remote
login name and password is prompted for on the terminal; the
-f flag forces login name and password prompting. A single
- indicates that the standard input from the local machine
is to be taken and transmitted to the remote machine, where
it will be the standard input for _c_o_m_m_a_n_d. Options do not
need to be separated by spaces, i.e. either ``-m C'' or
``-mC'' is accepted. There are also other options intended
to be used by higher level application programs and shell
scripts only; they will not be described here.
The net command prepares a file to be sent to the remote
machine and queues it in the `network queue.' _N_e_t_q (1) gives
information about the queues. The file `/_u_s_r/_n_e_t/_l_o_g_f_i_l_e'
has a cryptic indication of what has recently been sent and
received.
AUTHOR
Eric Schmidt
Printed 7/25/83 1
NET(1) UNIX Programmer's Manual NET(1)
FILES
/usr/spool/berknet/logfilethe log
/usr/spool/berknet/send? the directories where the queues
are
/usr/spool/berknet/rcv directory containing files received
/usr/spool/berknet/plogfile?log file including packet
transmission statistics
/usr/net/netstat? statistics file
SEE ALSO
mail(1), netcp(1), netlog(1), netlpr(1), netmail(1),
netq(1), netrm(1)
``An Introduction to the Berkeley Network", by Eric Schmidt
Printed 7/25/83 2