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 The cpu server can be specified with
 109 .B -h
 110 .IR host ,
 111 otherwise it defaults to the environment variable
 112 .B $cpu
 113 or is looked up from
 114 .IR ndb (6).
 115 .PP
 116 .I Rimport
 117 mounts a remote directory
 118 .I tree
 119 from a cpu server
 120 .I host
 121 into the local namespace at
 122 .IR mountpoint .
 123 When
 124 .I mountpoint
 125 is omitted, it is set the same as
 126 .IR tree .
 127 When the
 128 .B -s
 129 .I name
 130 option is present, the service is also posted to
 131 .BI /srv/ name
 132 allowing it to be mounted in other namespaces.
 133 .PP
 134 .I Rexport
 135 is the reverse of
 136 .IR rimport ,
 137 exporting a local directory
 138 .I tree
 139 to the server
 140 .I host
 141 and optionally executing
 142 .I remotecmd arg
 143 on the server side after posting the service to
 144 .BI /srv/ remotename
 145 or mounting it at
 146 .IR remotemtpt .
 147 .PP
 148 .I Rconnect
 149 is a helper program handling client side connection setup for
 150 the commands listed above. The rcpu protocol starts by setting up a mutual
 151 authenticated and encrypted TLS connection using
 152 .IR tlssrv (8)
 153 followed by the client sending an
 154 .IR rc (1)
 155 .I remotescript
 156 file to the server which gets executed under the authenticated user
 157 with file descriptors 0,1,2 cross connected to file descriptors 0,1
 158 of the client side running
 159 .I localcommand
 160 over the encrypted connection.
 161 .PP
 162 The common options are:
 163 .PD
 164 .TP
 165 .B -a -b -c -C -n -q
 166 Specifies the
 167 .I mount
 168 options (see
 169 .IR bind (1))
 170 for
 171 .I rimport
 172 and
 173 .IR rexport .
 174 .TP
 175 .B -P \fIpatternfile
 176 Restricts the set of exported files (see
 177 .IR exportfs (4))
 178 for
 179 .I rcpu
 180 and
 181 .IR rexport .
 182 .TP
 183 .B -u \fIuser
 184 Remote user id to authenticate as.
 185 .TP
 186 .B -k \fIkeypattern
 187 Use
 188 .I keypattern
 189 to select a key to authenticate to the remote side (see
 190 .IR auth (2)).
 191 .TP
 192 .B -p
 193 Protect the connection against connection resets by establishing
 194 .IR aan (8)
 195 tunnel.
 196 .SH FILES
 197 .B /rc/bin/service/tcp17019
 198 .SH SOURCE
 199 .B /rc/bin/rcpu
 200 .br
 201 .B /rc/bin/rimport
 202 .br
 203 .B /rc/bin/rexport
 204 .br
 205 .B /rc/bin/rconnect
 206 .SH "SEE ALSO"
 207 .IR rc (1) ,
 208 .IR cpu (1) ,
 209 .IR con (1) ,
 210 .IR import (4) ,
 211 .IR exportfs (4) ,
 212 .IR tlssrv (8) ,
 213 .IR aan (8)