sys/man/8/init

   1 .TH INIT 8
   2 .SH NAME
   3 init \- initialize machine upon booting
   4 .SH SYNOPSIS
   5 .B /$cputype/init
   6 [
   7 .B -ctm
   8 ] [
   9 .I command ...
  10 ]
  11 .SH DESCRIPTION
  12 .I Init
  13 initializes the machine: it establishes the name space (see
  14 .IR namespace (4)
  15 and
  16 .I newns
  17 in
  18 .IR auth (2)),
  19 and environment (see
  20 .IR env (3))
  21 and starts a shell
  22 .RI ( rc (1))
  23 on the console.
  24 If a
  25 .I command
  26 is supplied, that is run instead of the shell.
  27 On a CPU server the invoked shell runs
  28 .IR cpurc (8)
  29 before accepting commands on the console;
  30 on a terminal, it runs
  31 .IR termrc
  32 and then the user's profile.
  33 Options
  34 .B -t
  35 (terminal)
  36 and
  37 .B -c
  38 (CPU)
  39 force the behavior to correspond to the specified service class.
  40 Otherwise
  41 .I init
  42 uses the value of the environment variable
  43 .B $service
  44 to decide the service class.
  45 .PP
  46 .I Init
  47 sets environment variables
  48 .B $service
  49 (either to the incoming value or according to
  50 .B -t
  51 or
  52 .BR -c ),
  53 .B $objtype
  54 (to the value of
  55 .BR $cputype ),
  56 .B $user
  57 (to the contents of
  58 .BR #c/user ),
  59 and
  60 .B $timezone
  61 (to the contents of
  62 .BR /adm/timezone/local ).
  63 .PP
  64 With option
  65 .B -m
  66 .I init
  67 starts only an interactive shell
  68 regardless of the
  69 .I command
  70 or service class.
  71 .PP
  72 On a CPU server,
  73 .I init
  74 requires the machine's password to be supplied before starting
  75 .I rc
  76 on the console.
  77 .PP
  78 .I Init
  79 is invoked by
  80 .IR boot (8),
  81 which sets the arguments as appropriate.
  82 .SH SOURCE
  83 .B /sys/src/cmd/init.c
  84 .SH "SEE ALSO"
  85 .IR rc (1),
  86 .IR auth (2),
  87 .IR boot (8)