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