sys/man/1/rcpu

   1 .TH RCPU 1
   2 .SH NAME
   3 rcpu, rimport, rexport, rconnect \- connection to CPU server
   4 .SH SYNOPSIS
   5 .B rcpu
   6 [
   7 .B -u
   8 .I user
   9 ] [
  10 .B -k
  11 .I keypattern
  12 ] [
  13 .B -P
  14 .I patternfile
  15 ] [
  16 .B -p
  17 ] [
  18 .B -h
  19 .I host
  20 ] [
  21 .B -c
  22 .I cmd arg ...
  23 ]
  24 .PP
  25 .B rimport
  26 [
  27 .B -abcCnq
  28 ] [
  29 .B -s
  30 .I name
  31 ] [
  32 .B -u
  33 .I user
  34 ] [
  35 .B -k
  36 .I keypattern
  37 ] [
  38 .B -p
  39 ]
  40 .I host
  41 .I tree
  42 [
  43 .I mountpoint
  44 ]
  45 .PP
  46 .B rexport
  47 [
  48 .B -abcCnq
  49 ] [
  50 .B -s
  51 .I remotename
  52 ] [
  53 .B -m
  54 .I remotemtpt
  55 ] [
  56 .B -u
  57 .I user
  58 ] [
  59 .B -k
  60 .I keypattern
  61 ] [
  62 .B -P
  63 .I patternfile
  64 ] [
  65 .B -p
  66 ]
  67 .I tree
  68 .I host
  69 [
  70 .I remotecmd arg ...
  71 ]
  72 .PP
  73 .B rconnect
  74 [
  75 .B -u
  76 .I user
  77 ] [
  78 .B -k
  79 .I keypattern
  80 ] [
  81 .B -p
  82 ]
  83 .I host
  84 .I remotescript
  85 .I localcommand arg ...
  86 .SH DESCRIPTION
  87 .I Rcpu
  88 runs commands from
  89 .IR rc (1)
  90 on a cpu server with the local namespace exported to
  91 the remote side under
  92 .BR /mnt/term .
  93 The current directory, interrupt notes, standard file descriptors 0,1,2
  94 and
  95 .B /dev/cons
  96 are passed to the remote side. The command to run can be passed
  97 with
  98 .B -c
  99 .IR "cmd arg ..." ,
 100 otherwise an interactive shell is started. The user's profile
 101 is run before the command with
 102 .B $service
 103 set to
 104 .B cpu
 105 to allow further customization of the environment (see
 106 .IR rc (1)
 107 for more information).
 108 .PP
 109 .I Rimport
 110 mounts a remote directory
 111 .I tree
 112 from a cpu server
 113 .I host
 114 into the local namespace at
 115 .IR mountpoint .
 116 When
 117 .I mountpoint
 118 is omitted, it is set the same as
 119 .IR tree .
 120 When the
 121 .B -s
 122 .I name
 123 option is present, the service is also posted to
 124 .BI /srv/ name
 125 allowing it to be mounted in other namespaces.
 126 .PP
 127 .I Rexport
 128 is the reverse of
 129 .IR rimport ,
 130 exporting a local directory
 131 .I tree
 132 to the server
 133 .I host
 134 and optionally executing
 135 .I remotecmd arg
 136 on the server side after posting the service to
 137 .BI /srv/ remotename
 138 or mounting it at
 139 .IR remotemtpt .
 140 .PP
 141 .I Rconnect
 142 is a helper program handling client side connection setup for
 143 the commands listed above. The rcpu protocol starts by setting up a mutual
 144 authenticated and encrypted TLS connection using
 145 .IR tlssrv (8)
 146 followed by the client sending an
 147 .IR rc (1)
 148 .I remotescript
 149 file to the server which gets executed under the authenticated user
 150 with file descriptors 0,1,2 cross connected to file descriptors 0,1
 151 of the client side running
 152 .I localcommand
 153 over the encrypted connection.
 154 .PP
 155 The common options are:
 156 .PD
 157 .TP
 158 .B -a -b -c -C -n -q
 159 Specifies the
 160 .I mount
 161 options (see
 162 .IR bind (1))
 163 for
 164 .I rimport
 165 and
 166 .IR rexport .
 167 .TP
 168 .B -P \fIpatternfile
 169 Restricts the set of exported files (see
 170 .I exportfs (4))
 171 for
 172 .I rcpu
 173 and
 174 .IR rexport .
 175 .TP
 176 .B -u \fIuser
 177 Remote user id to authenticate as.
 178 .TP
 179 .B -k \fIkeypattern
 180 Use
 181 .I keypattern
 182 to select a key to authenticate to the remote side (see
 183 .IR auth (2)).
 184 .TP
 185 .B -p
 186 Protect the connection against connection resets by establishing
 187 .IR aan (8)
 188 tunnel.
 189 .SH FILES
 190 .B /rc/bin/service/tcp17019
 191 .SH SOURCE
 192 .B /rc/bin/rcpu
 193 .br
 194 .B /rc/bin/rimport
 195 .br
 196 .B /rc/bin/rexport
 197 .br
 198 .B /rc/bin/rconnect
 199 .SH "SEE ALSO"
 200 .IR rc (1) ,
 201 .IR cpu (1) ,
 202 .IR con (1) ,
 203 .IR import (4) ,
 204 .IR exportfs (4) ,
 205 .IR tlssrv (8) ,
 206 .IR aan (8)