mirror of
git://git.9front.org/plan9front/plan9front
synced 2025-01-12 11:10:06 +00:00
provide rcpu(1), make usage line consistent
This commit is contained in:
cinap_lenrek
parent
b450cb7e32
commit
86dfd3cf16
5 changed files with 210 additions and 4 deletions
|
|
@ -3,7 +3,7 @@ rfork e
|
||||||
|
|
||||||
argv0=$0
|
argv0=$0
|
||||||
fn usage {
|
fn usage {
|
||||||
echo 'usage:' $argv0 '[-p] [-u user] [-k keyspec] host remotescript localcommand ...' >[1=2]
|
echo 'usage:' $argv0 '[-u user] [-k keypattern] [-p] host remotescript localcommand arg ...' >[1=2]
|
||||||
exit 'usage'
|
exit 'usage'
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -3,7 +3,7 @@ rfork e
|
||||||
|
|
||||||
argv0=$0
|
argv0=$0
|
||||||
fn usage {
|
fn usage {
|
||||||
echo 'usage:' $argv0 '[-p] [-h host] [-u user] [-k keypattern] [-P patternfile] [-c cmd arg ...]' >[1=2]
|
echo 'usage:' $argv0 '[-u user] [-k keypattern] [-P patternfile] [-p] [-h host] [-c cmd arg ...]' >[1=2]
|
||||||
exit 'usage'
|
exit 'usage'
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -3,7 +3,7 @@ rfork e
|
||||||
|
|
||||||
argv0=$0
|
argv0=$0
|
||||||
fn usage {
|
fn usage {
|
||||||
echo 'usage:' $argv0 '[options] [-s remotesrv] [-m remotemtpt] tree host [remotecmd [args ...]]' >[1=2]
|
echo 'usage:' $argv0 '[-abcCnq] [-s remotename] [-m remotemtpt] [-u user] [-k keypattern] [-P patternfile] [-p] tree host [remotecmd [args ...]]' >[1=2]
|
||||||
exit 'usage'
|
exit 'usage'
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -3,7 +3,7 @@ rfork e
|
||||||
|
|
||||||
argv0=$0
|
argv0=$0
|
||||||
fn usage {
|
fn usage {
|
||||||
echo 'usage:' $argv0 '[options] host tree [mountpoint]' >[1=2]
|
echo 'usage:' $argv0 '[-abcCnq] [-s name] [-u user] [-k keypattern] [-p] host tree [mountpoint]' >[1=2]
|
||||||
exit 'usage'
|
exit 'usage'
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
206
sys/man/1/rcpu
Normal file
206
sys/man/1/rcpu
Normal file
|
|
@ -0,0 +1,206 @@
|
||||||
|
.TH RCPU 1
|
||||||
|
.SH NAME
|
||||||
|
rcpu, rimport, rexport, rconnect \- connection to CPU server
|
||||||
|
.SH SYNOPSIS
|
||||||
|
.B rcpu
|
||||||
|
[
|
||||||
|
.B -u
|
||||||
|
.I user
|
||||||
|
] [
|
||||||
|
.B -k
|
||||||
|
.I keypattern
|
||||||
|
] [
|
||||||
|
.B -P
|
||||||
|
.I patternfile
|
||||||
|
] [
|
||||||
|
.B -p
|
||||||
|
] [
|
||||||
|
.B -h
|
||||||
|
.I host
|
||||||
|
] [
|
||||||
|
.B -c
|
||||||
|
.I cmd arg ...
|
||||||
|
]
|
||||||
|
.PP
|
||||||
|
.B rimport
|
||||||
|
[
|
||||||
|
.B -abcCnq
|
||||||
|
] [
|
||||||
|
.B -s
|
||||||
|
.I name
|
||||||
|
] [
|
||||||
|
.B -u
|
||||||
|
.I user
|
||||||
|
] [
|
||||||
|
.B -k
|
||||||
|
.I keypattern
|
||||||
|
] [
|
||||||
|
.B -p
|
||||||
|
]
|
||||||
|
.I host
|
||||||
|
.I tree
|
||||||
|
[
|
||||||
|
.I mountpoint
|
||||||
|
]
|
||||||
|
.PP
|
||||||
|
.B rexport
|
||||||
|
[
|
||||||
|
.B -abcCnq
|
||||||
|
] [
|
||||||
|
.B -s
|
||||||
|
.I remotename
|
||||||
|
] [
|
||||||
|
.B -m
|
||||||
|
.I remotemtpt
|
||||||
|
] [
|
||||||
|
.B -u
|
||||||
|
.I user
|
||||||
|
] [
|
||||||
|
.B -k
|
||||||
|
.I keypattern
|
||||||
|
] [
|
||||||
|
.B -P
|
||||||
|
.I patternfile
|
||||||
|
] [
|
||||||
|
.B -p
|
||||||
|
]
|
||||||
|
.I tree
|
||||||
|
.I host
|
||||||
|
[
|
||||||
|
.I remotecmd arg ...
|
||||||
|
]
|
||||||
|
.PP
|
||||||
|
.B rconnect
|
||||||
|
[
|
||||||
|
.B -u
|
||||||
|
.I user
|
||||||
|
] [
|
||||||
|
.B -k
|
||||||
|
.I keypattern
|
||||||
|
] [
|
||||||
|
.B -p
|
||||||
|
]
|
||||||
|
.I host
|
||||||
|
.I remotescript
|
||||||
|
.I localcommand arg ...
|
||||||
|
.SH DESCRIPTION
|
||||||
|
.I Rcpu
|
||||||
|
runs commands from
|
||||||
|
.IR rc (1)
|
||||||
|
on a cpu server with the local namespace exported to
|
||||||
|
the remote side under
|
||||||
|
.BR /mnt/term .
|
||||||
|
The current directory, interrupt notes, standard file descriptors 0,1,2
|
||||||
|
and
|
||||||
|
.B /dev/cons
|
||||||
|
are passed to the remote side. The command to run can be passed
|
||||||
|
with
|
||||||
|
.B -c
|
||||||
|
.IR "cmd arg ..." ,
|
||||||
|
otherwise a interactive shell is started. The user's profile
|
||||||
|
is run before the command with
|
||||||
|
.B $service
|
||||||
|
set to
|
||||||
|
.B cpu
|
||||||
|
to allow further customization of the environment (see
|
||||||
|
.IR rc (1)
|
||||||
|
for more information).
|
||||||
|
.PP
|
||||||
|
.I Rimport
|
||||||
|
mounts a remote directory
|
||||||
|
.I tree
|
||||||
|
from a cpu server
|
||||||
|
.I host
|
||||||
|
into the local namespace at
|
||||||
|
.IR mountpoint .
|
||||||
|
When
|
||||||
|
.I mountpoint
|
||||||
|
is omitted, it is set the same as
|
||||||
|
.IR tree .
|
||||||
|
When the
|
||||||
|
.B -s
|
||||||
|
.I name
|
||||||
|
option is present, the service is also posted to
|
||||||
|
.BI /srv/ name
|
||||||
|
allowing it to be mounted in other namespaces.
|
||||||
|
.PP
|
||||||
|
.I Rexport
|
||||||
|
is the reverse of
|
||||||
|
.IR rimport ,
|
||||||
|
exporting a local directory
|
||||||
|
.I tree
|
||||||
|
to the server
|
||||||
|
.I host
|
||||||
|
and optionally executing
|
||||||
|
.I remotecmd arg
|
||||||
|
on the server side after posting the service to
|
||||||
|
.BI /srv/ remotename
|
||||||
|
or mounting it at
|
||||||
|
.IR remotemtpt .
|
||||||
|
.PP
|
||||||
|
.I Rconnect
|
||||||
|
is a helper program handling client side connection setup for
|
||||||
|
the commands listed above. The rcpu protocol starts by setting up a mutual
|
||||||
|
authenticated and encrypted TLS connection using
|
||||||
|
.IR tlssrv (8)
|
||||||
|
followed by the client sending a
|
||||||
|
.IR rc (1)
|
||||||
|
.I remotescript
|
||||||
|
file to the server which gets executed under the authenticated user
|
||||||
|
with file descriptors 0,1,2 cross connected to file descriptors 0,1
|
||||||
|
of the client side running
|
||||||
|
.I localcommand
|
||||||
|
over the encrypted connection.
|
||||||
|
.PP
|
||||||
|
The common options are:
|
||||||
|
.PD
|
||||||
|
.TP
|
||||||
|
.B -a -b -c -C -n -q
|
||||||
|
Specifies the
|
||||||
|
.I mount
|
||||||
|
options (see
|
||||||
|
.IR bind (1))
|
||||||
|
for
|
||||||
|
.I rimport
|
||||||
|
and
|
||||||
|
.IR rexport .
|
||||||
|
.TP
|
||||||
|
.B -P \fIpatternfile
|
||||||
|
Restricts the set of exported files (see
|
||||||
|
.I exportfs (4))
|
||||||
|
for
|
||||||
|
.I rcpu
|
||||||
|
and
|
||||||
|
.IR rexport .
|
||||||
|
.TP
|
||||||
|
.B -u \fIuser
|
||||||
|
Remote user id to authenticate as.
|
||||||
|
.TP
|
||||||
|
.B -k \fIkeypattern
|
||||||
|
Use
|
||||||
|
.I keypattern
|
||||||
|
to select a key to authenticate to the remote side (see
|
||||||
|
.IR auth (2)).
|
||||||
|
.TP
|
||||||
|
.B -p
|
||||||
|
Protect the connection against connection resets by establishing
|
||||||
|
.IR aan (8)
|
||||||
|
tunnel.
|
||||||
|
.SH FILES
|
||||||
|
.B /rc/bin/service/tcp17019
|
||||||
|
.SH SOURCE
|
||||||
|
.B /rc/bin/rcpu
|
||||||
|
.br
|
||||||
|
.B /rc/bin/rimport
|
||||||
|
.br
|
||||||
|
.B /rc/bin/rexport
|
||||||
|
.br
|
||||||
|
.B /rc/bin/rconnect
|
||||||
|
.SH "SEE ALSO"
|
||||||
|
.IR rc (1) ,
|
||||||
|
.IR cpu (1) ,
|
||||||
|
.IR con (1) ,
|
||||||
|
.IR import (4) ,
|
||||||
|
.IR exportfs (4) ,
|
||||||
|
.IR tlssrv (8) ,
|
||||||
|
.IR aan (8)
|
||||||
Loading…
Reference in a new issue