sys/man/4/dossrv

   1 .TH DOSSRV 4
   2 .SH NAME
   3 dossrv, 9660srv, dosmnt, eject \- DOS and ISO9660 file systems
   4 .SH SYNOPSIS
   5 .B dossrv
   6 [
   7 .B -rsv
   8 ] [
   9 .B -f
  10 .I file
  11 ] [
  12 .I service
  13 ]
  14 .PP
  15 .B 9660srv
  16 [
  17 .B -9Jsv
  18 ] [
  19 .B -c
  20 .I clusters
  21 ] [
  22 .B -f
  23 .I file
  24 ] [
  25 .I service
  26 ]
  27 .PP
  28 .B dosmnt
  29 .I n
  30 .I mtpt
  31 .PP
  32 .B eject
  33 [
  34 .I n
  35 ]
  36 .SH DESCRIPTION
  37 .I Dossrv
  38 is a file server that interprets DOS file systems.
  39 A single instance of
  40 .I dossrv
  41 can provide access to multiple DOS disks simultaneously.
  42 .PP
  43 .I Dossrv
  44 posts a file descriptor named
  45 .I service
  46 (default
  47 .BR dos )
  48 in the
  49 .B /srv
  50 directory.
  51 To access the DOS file system on a device, use
  52 .B mount
  53 with the
  54 .I spec
  55 argument
  56 (see
  57 .IR bind (1))
  58 the name of the file holding raw DOS file system, typically the disk.
  59 If
  60 .I spec
  61 is undefined in the
  62 .BR mount ,
  63 .I dossrv
  64 will use
  65 .I file
  66 as the default name for the device holding the DOS system.
  67 .PP
  68 Normally
  69 .I dossrv
  70 creates a pipe to act as the communications channel between
  71 itself and its clients.
  72 The
  73 .B -s
  74 flag instructs
  75 .I dossrv
  76 to use its standard input and output instead.
  77 The kernels use this option if they are booting from a DOS disk.
  78 This flag also prevents the creation of an explicit service file in
  79 .BR /srv .
  80 .PP
  81 The
  82 .B -v
  83 flag causes verbose output for debugging, while
  84 the
  85 .B -r
  86 flag makes the file system read-only.
  87 .PP
  88 The file attribute flags used by the DOS file system
  89 do not map directly to those used by Plan 9.
  90 Since there is no concept of user or group,
  91 permission changes via
  92 .B wstat
  93 (see
  94 .IR stat (2))
  95 will fail unless the same (read, write, execute) permissions
  96 are specified for user, group, and other.
  97 For example, removing write permission in Plan 9
  98 corresponds to setting the read-only
  99 attribute in the DOS file system.
 100 Most of the other DOS attributes
 101 are not accessible.
 102 .PP
 103 Setting the exclusive use flag (DMEXCL)
 104 in Plan 9 corresponds to setting the
 105 system use attribute in the DOS file system.
 106 Such files are not actually restricted to exclusive use,
 107 but do merit special treatment that
 108 helps in the creation of boot disks:
 109 when
 110 .I dossrv
 111 allocates a new block for such a file
 112 (caused, say, by a write that fills the file's
 113 last allocated block), it succeeds only if it can
 114 arrange for the file to be stored
 115 contiguously on disk.
 116 .PP
 117 Since other operating systems do not
 118 guarantee that system files are laid
 119 out contiguously, the DMAPPEND mode
 120 bit is set in file stat information
 121 only when the file is currently contiguous.
 122 Attempts to set the DMAPPEND mode bit
 123 explicitly will cause
 124 .I dossrv
 125 to try to make the file contiguous,
 126 succeeding only if this is possible.
 127 .PP
 128 .I 9660srv
 129 is similar to
 130 .I dossrv
 131 in specification, except that it interprets ISO9660 CD-ROM
 132 file systems instead of DOS file systems.
 133 Some CDs contain multiple directory trees describing
 134 the same set of files.
 135 .IR 9660srv 's
 136 first choice in such a case is a standard ISO9660 tree
 137 with Plan 9 system use fields;
 138 the second choice is a Microsoft ``Joliet'' tree, which
 139 allows long file names and Unicode characters;
 140 the third choice is a standard ISO9660 or High Sierra tree.
 141 The
 142 .B -9
 143 flag causes
 144 .I 9660srv
 145 to ignore the Plan 9 system use fields,
 146 while the
 147 .B -J
 148 flag causes it to
 149 ignore the Joliet tree.
 150 The
 151 .B -c
 152 option sets the size of the RAM cache to
 153 .I clusters
 154 clusters of 128KB.
 155 The default
 156 .I clusters
 157 is 16,
 158 but a value of 5600 will cache an entire CD incrementally.
 159 .PP
 160 If the floppy drive has an ejection motor,
 161 .I eject
 162 will spit out the floppy from drive
 163 .IR n ,
 164 default 0.
 165 .SH "SEE ALSO"
 166 .IR kfs (4)
 167 .SH SOURCE
 168 .B /sys/src/cmd/dossrv
 169 .br
 170 .B /sys/src/cmd/9660srv
 171 .br
 172 .B /rc/bin/eject
 173 .br
 174 .B /rc/bin/dosmnt
 175 .SH BUGS
 176 The overloading of the semantics of
 177 the DMEXCL and DMAPPEND
 178 bits can be confusing.