sys/man/4/fs

   1 .TH FS 4
   2 .SH NAME
   3 fs \- file server, dump
   4 .SH SYNOPSIS
   5 .I none
   6 .SH DESCRIPTION
   7 The file server was the main file system for Plan 9.
   8 It was a stand-alone system that ran on
   9 a separate computer.
  10 It served the Plan 9 protocol via the IL/IP
  11 protocols on Ethernets.
  12 The name of the main file server at Murray Hill was
  13 .BR emelie .
  14 .PP
  15 The file server normally requires all users except
  16 .L none
  17 to provide authentication tickets on each
  18 .IR attach (5).
  19 This can be disabled using the
  20 .B noauth
  21 configuration command (see
  22 .IR fsconfig (8)).
  23 .PP
  24 The group numbered 9999, normally called
  25 .BR noworld ,
  26 is special
  27 on the file server.  Any user belonging to that group has
  28 attenuated access privileges.  Specifically, when checking such
  29 a user's access to files, the file's permission bits are first ANDed
  30 with 0770 for normal files or 0771 for directories.  The effect is
  31 to deny world access permissions to
  32 .B noworld
  33 users, except
  34 when walking directories.
  35 .PP
  36 The user
  37 .B none
  38 is always allowed to attach to
  39 .B emelie
  40 without authentication but has minimal permissions.
  41 .PP
  42 .B Emelie
  43 maintains three file systems
  44 on a combination of disks and
  45 write-once-read-many (WORM) magneto-optical disks.
  46 .TP
  47 .B other
  48 is a simple disk-based file system not backed by
  49 the worm.
  50 .TP
  51 .B main
  52 is a worm-based file system with a disk-based
  53 look-aside cache.
  54 The disk cache holds
  55 modified worm blocks
  56 to overcome the write-once property of the worm.
  57 The cache also holds recently accessed
  58 non-modified blocks to
  59 speed up the effective access time of the worm.
  60 Occasionally
  61 (usually daily at 5AM) the modified blocks in the
  62 disk cache are
  63 .IR dumped .
  64 At this time,
  65 traffic to the file system is halted and the
  66 modified blocks are relabeled to the unwritten
  67 portion of the worm.
  68 After the dump,
  69 the file system traffic is continued and
  70 the relabeled blocks are copied to the worm by
  71 a background process.
  72 .TP
  73 .B dump
  74 Each time the main file system is dumped,
  75 its root is appended to a subdirectory of the dump file system.
  76 Since the dump file system is not mirrored with a disk
  77 cache,
  78 it is read-only.
  79 The name of the newly added root is created from the date
  80 of the dump:
  81 .BI / yyyy / mmdds\f1.
  82 Here
  83 .I yyyy
  84 is the full year,
  85 .I mm
  86 is the month number,
  87 .I dd
  88 is the day number and
  89 .I s
  90 is a sequence number if more than
  91 one dump is done in a day.
  92 For the first dump,
  93 .I s
  94 is null.
  95 For the subsequent dumps
  96 .I s
  97 is 1, 2, 3, etc.
  98 .sp
  99 The root of the main file system
 100 that is frozen on the first dump
 101 of March 1, 1992
 102 will be named
 103 .B /1992/0301/
 104 in the dump file system.
 105 .SH EXAMPLES
 106 Place the root of the
 107 .B dump
 108 file system on
 109 .B /n/dump
 110 and show the modified times of the MIPS C compiler
 111 over all dumps in February, 1992:
 112 .IP
 113 .EX
 114 9fs dump
 115 ls -l /n/dump/1992/02??/mips/bin/vc
 116 .EE
 117 .PP
 118 To get only one line of output for each version of the compiler:
 119 .IP
 120 .EX
 121 ls -lp /n/dump/1992/02??/mips/bin/vc | uniq
 122 .EE
 123 .PP
 124 Make the
 125 .B other
 126 file system available in directory
 127 .BR /n/emelieother :
 128 .IP
 129 .EX
 130 mount -c /srv/boot /n/emelieother other
 131 .EE
 132 .SH SOURCE
 133 .B /sys/src/fs
 134 .SH SEE ALSO
 135 .IR yesterday (1),
 136 .IR cwfs (4),
 137 .IR srv (4),
 138 .IR fs (8)
 139 .br
 140 Sean Quinlan,
 141 ``A Cached WORM File System'',
 142 .I
 143 Software \- Practice and Experience,
 144 December, 1991
 145 .SH BUGS
 146 For the moment, the file server serves both the old (third edition) and new (fourth
 147 edition) versions of 9P, deciding which to serve by sniffing the first packet on each
 148 connection.
 149 .PP
 150 Required IL, thus now deprecated.