sys/man/4/paqfs

   1 .TH PAQFS 4
   2 .SH NAME
   3 paqfs  \- compressed read-only file system
   4 .SH SYNOPSIS
   5 .B paqfs
   6 [
   7 .B -disv
   8 ]
   9 [
  10 .B -c
  11 .I cachesize
  12 ]
  13 [
  14 .B -m
  15 .I mtpt
  16 ]
  17 [
  18 .B -M
  19 .I mesgsize
  20 ]
  21 [
  22 .B -S
  23 .I srvname
  24 ]
  25 .I paqfile
  26 .SH DESCRIPTION
  27 .I Paqfs
  28 interprets the compressed read-only file system created by
  29 .IR mkpaqfs (8)
  30 and stored in
  31 .I paqfile
  32 so that it can be mounted into a Plan 9 file system.
  33 .I Paqfs
  34 is typically used to create a stand alone file system for
  35 a small persistent storage device, such as a flash ROM.
  36 It does not authenticate its clients and assumes each group
  37 has a single member with the same name.
  38 .PP
  39 Options to
  40 .I paqfs
  41 are:
  42 .TP
  43 .BI -c " cachesize
  44 The number of file system blocks to cache in memory. The default is 20 blocks.
  45 .TP
  46 .BI -M " mesgsize
  47 The maximum 9P message size. The default is sufficient for 8K byte read message.
  48 .TP
  49 .B -d
  50 Output various debugging information to
  51 .IR stderr .
  52 .TP
  53 .B -i
  54 Use file descriptors 0 and 1 as the 9P communication channel rather than create a pipe.
  55 .TP
  56 .B -q
  57 Suppress the output of the archive creation date and fingerprint to
  58 .IR stderr .
  59 .TP
  60 .BI -m " mtpt
  61 The location to mount the file system. The default is
  62 .BR /n/paq .
  63 .TP
  64 .B -s
  65 Post the 9P channel on
  66 .BR #s/\fIsrvname\fR ,
  67 default
  68 .BR #s/paqfs ,
  69 rather than
  70 mounting it on
  71 .IR mtpt .
  72 .TP
  73 .B -S
  74 The name to post in
  75 .BR #s .
  76 The default is
  77 .BR paqfs .
  78 .TP
  79 .B -p
  80 Both post the 9P channel in
  81 .B #s
  82 and
  83 mount the
  84 .I paqfile
  85 in to the filesystem.
  86 .TP
  87 .B -v
  88 Verify the integrity of the
  89 .IR paqfile .
  90 Before mounting the file system, the
  91 entire file is parsed and the
  92 .I sha1
  93 checksum of the file system data is compared to the checksum embedded in the file.
  94 This option enables the use of
  95 .I paqfs
  96 with files that consist of a
  97 .I paq
  98 file system concatenated with additional data.
  99 .SH SOURCE
 100 .B /sys/src/cmd/paqfs/paqfs.c
 101 .SH "SEE ALSO"
 102 .IR mkpaqfs (8)