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