| 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) %G% |
| 6 | .\" |
| 7 | .TH NET 1 "%G%" |
| 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 |