man/vsh.8

   1 .de Sh \" Subsection
   2 .br
   3 .if t .Sp
   4 .ne 5
   5 .PP
   6 \fB\\$1\fR
   7 .PP
   8 ..
   9 .de Sp \" Vertical space (when we can't use .PP)
  10 .if t .sp .5v
  11 .if n .sp
  12 ..
  13 .de Ip \" List item
  14 .br
  15 .ie \\n(.$>=3 .ne \\$3
  16 .el .ne 3
  17 .IP "\\$1" \\$2
  18 ..
  19 .TH "VSH" 8 "2004-07-29" "PlanetLab specific Vserver shell" "vsh"
  20
  21 .SH NAME
  22 vsh \- Safely trampoline's a slice user from global vserver context to
  23 the correspondingly named local vserver context\&.
  24
  25 .SH "SYNOPSIS"
  26
  27 .PP
  28 \fBvsh\fR [COMMAND] \fR
  29
  30 .TP
  31 [COMMAND]
  32 when specified, the command to run, otherwise vsh will just run the
  33 user's shell as a login shell
  34
  35 .SH "SUMMARY"
  36
  37 .PP
  38 vsh is used as the login shell for slice users in the global vserver's
  39 /etc/passwd\&. It is invoked either by sshd when a slice user logs on
  40 to a PlanetLab node or as root using the su command\&. When this
  41 occurs, vsh switches vserver context and sets the uid/gid of the slice
  42 user, as specified in the slice's vserver /etc/passwd\&.
  43
  44 .PP
  45 vsh assumes that the same account (by name) used to ssh/su into the
  46 vserver also exists in the vserver specific /etc/passwd file\&.  This
  47 is the only reason that for now it is deemed to be PlanetLab
  48 specific\&.