Annotation of 43BSDTahoe/old/man/net.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)net.1       6.1 (Berkeley) 4/29/85
                      6: .\"
                      7: .TH NET 1 "4/29/85"
                      8: .UC 4
                      9: .ds s 1
                     10: .ds o 1
                     11: .SH NAME
                     12: net \- execute a command on a remote machine
                     13: .SH SYNOPSIS
                     14: .B net
                     15: [
                     16: .B \-m
                     17: machine ] [
                     18: .B \-l
                     19: login
                     20: ] [
                     21: .B \-p
                     22: password ] [
                     23: .B \-r
                     24: respfile ] [
                     25: .B \-
                     26: ] [
                     27: .B \-f
                     28: ] [
                     29: .B \-n
                     30: ] [
                     31: .B \-q
                     32: ]
                     33: command
                     34: .SH DESCRIPTION
                     35: The
                     36: .I net
                     37: command sends the specified 
                     38: .I command
                     39: (which should be enclosed in quotes) over the network to the specified
                     40: (or default) remote machine.
                     41: The network will notify the user when the command has
                     42: been executed and will return to him any output or error indication by `writing'
                     43: (see
                     44: .IR  write (\*o))
                     45: to the terminal if he is still logged in, or `mailing' (see
                     46: .IR  mail (\*o))
                     47: otherwise.
                     48: .PP
                     49: There are a number of options, which must precede the command.
                     50: Options may be specified on the command line, preceding
                     51: the command, or in a file ``.netrc'' in the user's login directory.
                     52: The ``.netrc'' file is not described here.
                     53: The
                     54: .B \-m
                     55: option specifies the desired remote machine.
                     56: If a remote machine is not specified, the default one is used.
                     57: The machine name may be a one letter abbreviation or a full name;
                     58: upper\- and lower\-case distinctions are ignored.
                     59: If the standard output and standard error files are to be saved, the
                     60: .B \-r
                     61: option returns to the originating user a file
                     62: .I (respfile)
                     63: containing the standard output and error files
                     64: when the command was executed on the remote machine.
                     65: If this option is used, no message is written back.
                     66: The presence of a non-zero length
                     67: .I respfile
                     68: indicates completion.
                     69: The
                     70: .B \-q
                     71: option suppresses all acknowledgements unless an error occurs, there is
                     72: output from the command, or the exit code of
                     73: .I command
                     74: is non-zero.
                     75: .PP
                     76: If the
                     77: .B \-l
                     78: and
                     79: .B \-p
                     80: options are not specified,
                     81: and the login name and password are not in the ``.netrc'' file,
                     82: a remote login name and password is prompted for on the terminal;
                     83: the
                     84: .B \-f
                     85: flag forces login name and password prompting.
                     86: A single
                     87: .B \-
                     88: indicates that the standard input from the local machine is to be taken
                     89: and transmitted to the remote machine, where it will be the standard input for
                     90: .I command.
                     91: The
                     92: .B \-n
                     93: flag forces all acknowledgment and output messages to be mailed
                     94: rather than written on the terminal.
                     95: Options do not need to be separated by spaces,
                     96: i.e. either ``\-m C'' or ``\-mC'' is accepted.
                     97: There are also other options intended to be used by
                     98: higher level application programs and shell scripts only;
                     99: they will not be described here.
                    100: .PP
                    101: The net command prepares a file to be sent to the remote machine
                    102: and queues it in the `network queue.'
                    103: .I Netq
                    104: (\*s) gives information about the queues.
                    105: .SH AUTHOR
                    106: Eric Schmidt
                    107: .SH FILES
                    108: .ta 2.5i
                    109: /usr/spool/berknet/logfile     logfile with information about net activity
                    110: .br
                    111: /usr/spool/berknet/plogfile?   log file including packet transmission statistics
                    112: .br
                    113: /usr/spool/berknet/netstat?    statistics file
                    114: .br
                    115: /usr/net/network.map   local network names and topology
                    116: .SH BUGS
                    117: .B \-q
                    118: should be the default.
                    119: .SH "SEE ALSO"
                    120: netrm(\*s), netq(\*s), netlog(\*s), netcp(\*s),
                    121: netlpr(\*s), netmail(\*s), netlogin(\*s), mail(\*o)
                    122: .br
                    123: ``An Introduction to the Berkeley Network", by Eric Schmidt

unix.superglobalmegacorp.com

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