|
|
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
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.