sys/man/4/ext2srv

   1 .TH EXT2SRV 4
   2 .SH NAME
   3 ext2srv \- ext2 file system
   4 .SH SYNOPSIS
   5 .B ext2srv
   6 [
   7 .B -vrs
   8 ] [
   9 .B -f
  10 .I file
  11 ] [
  12 .B -p
  13 .I passwd
  14 ] [
  15 .B -g
  16 .I group
  17 ] [
  18 .I service
  19 ]
  20 .SH DESCRIPTION
  21 .I Ext2srv
  22 is a file server that interprets the Linux Second Extended File System.
  23 A single instance of
  24 .I ext2srv
  25 can provide access to multiple ext2 partitions simultaneously.
  26 .PP
  27 .I Ext2srv
  28 posts a file descriptor named
  29 .I service
  30 (default
  31 .BR ext2 )
  32 in the
  33 .B /srv
  34 directory.
  35 To access an ext2 file system on a device, use
  36 .B mount
  37 with the
  38 .I spec
  39 argument
  40 (see
  41 .IR bind (1))
  42 the name of the file holding the raw ext2 file system, typically the disk or partition.
  43 If
  44 .I spec
  45 is undefined in the
  46 .BR mount ,
  47 .I ext2srv
  48 will use
  49 .I file
  50 as the default name for the device holding the file system.
  51 .PP
  52 Normally
  53 .I ext2srv
  54 creates a pipe to act as the communications channel between
  55 itself and its clients.
  56 The
  57 .B -s
  58 flag instructs
  59 .I ext2srv
  60 to use its standard input and output instead.
  61 This flag also prevents the creation of an explicit service file in
  62 .BR /srv .
  63 .PP
  64 The
  65 .B -v
  66 flag causes verbose output for debugging, while
  67 the
  68 .B -r
  69 flag (recommended) makes the file system read-only.
  70 The optional
  71 .B -p
  72 and
  73 .B -g
  74 flags specify Unix-format password (respectively group) files
  75 that give the mapping between the numeric user- and group-ID
  76 numbers in the ext2 file system and the strings reported by Plan 9 status
  77 inquiries.
  78 .PP
  79 There is no authentication or permission checking.
  80 Anyone who can access the ext2 file system will have full access
  81 to all its files, including write access if
  82 .I ext2srv
  83 is not started with the
  84 .B -r
  85 flag, irrespective of file ownership and permission flags.
  86 .PP
  87 Some file system state is cached in memory, and may
  88 be flushed only when the file system is unmounted.
  89 Therefore if
  90 .I ext2srv
  91 is stopped or the machine is rebooted while an ext2 file system
  92 is still mounted,
  93 the superblock on the device will have been marked `not valid'
  94 (unless the
  95 .B -r
  96 flag was used),
  97 and a
  98 .I fsck
  99 will be required before that file system may be mounted again.
 100 .SH BUGS
 101 There is no authentication or permission checking.
 102 The implementation has not tracked any changes to the ext2
 103 specification since it was written.
 104 There may be other bugs.
 105 It is advisable to use
 106 .I ext2srv
 107 in read-only mode whenever possible.
 108 .SH AUTHOR
 109 Bodet Laurent (bl@mime.univ-paris8.fr),
 110 with later updates by Russ Cox and Richard Miller.