BSD 3 development

Work on file usr/man/man1/net.1

Synthesized-from: 3bsd

diff --git a/usr/man/man1/net.1 b/usr/man/man1/net.1
new file mode 100644 (file)
index 0000000..f7ed547
--- /dev/null
+++ b/usr/man/man1/net.1
@@ -0,0 +1,113 @@
+.TH NET 1 2/24/79
+.UC
+.ds s 1
+.ds o 1
+.SH NAME
+net \- execute a command on a remote machine
+.SH SYNOPSIS
+.B net
+[
+.B \-m
+machine ] [
+.B \-l
+login
+] [
+.B \-p
+password ] [
+.B \-r
+respfile ] [
+.B \-
+] [
+.B \-f
+] [
+.B \-n
+]
+command
+.SH DESCRIPTION
+The
+.I net
+command sends the specified 
+.I command
+(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
+.IR  write (\*o))
+to the terminal if the user is still logged in,
+or `mailing' (see
+.IR  mail (\*o))
+otherwise.
+.PP
+There are a number of options, which must precede the command.
+Options may be specified on the command line, preceding
+the command, or in a file ``.netrc'' in the user's login directory.
+The ``.netrc'' file is not described here.
+The
+.B \-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
+.B \-r
+option returns to the
+originating user a file
+.I (respfile)
+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 presence of a non-zero length
+.I respfile
+indicates completion.
+The
+.B \-n
+option suppresses all acknowledgements, including error messages.
+.PP
+If the
+.B \-l
+and
+.B \-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
+.B \-f
+flag forces login name and password prompting.
+A single
+.B \-
+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
+.I command.
+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.
+.PP
+The net command prepares a file to be sent to the remote machine
+and queues it in the `network queue.'
+.I Netq
+(\*s) gives information about the queues.
+The file
+.I `/usr/net/logfile'
+has a cryptic indication of what has recently been sent and received.
+.SH AUTHOR
+Eric Schmidt
+.SH FILES
+.ta 2.5i
+/usr/spool/berknet/logfile     the log
+.br
+/usr/spool/berknet/send?       the directories where the queues are
+.br
+/usr/spool/berknet/rcv directory containing files received
+.br
+/usr/spool/berknet/plogfile?   log file including packet transmission statistics
+.br
+/usr/spool/berknet/netstat?    statistics file
+.SH "SEE ALSO"
+netrm(\*s), netq(\*s), netlog(\*s), netcp(\*s),
+netlpr(\*s), netmail(\*s),
+mail(\*o)
+.br
+``An Introduction to the Berkeley Network", by Eric Schmidt