Hex Artifact Content

Artifact eeca8d46496b6ffaeef202c882bbaa6f511a5f92:


0000: 2e 54 48 20 41 50 50 46 53 44 20 38 20 22 32 39  .TH APPFSD 8 "29
0010: 20 44 45 43 20 32 30 31 34 22 20 22 41 70 70 46   DEC 2014" "AppF
0020: 53 20 40 40 56 45 52 53 40 40 22 0a 2e 53 48 20  S @@VERS@@"..SH 
0030: 4e 41 4d 45 0a 61 70 70 66 73 64 2c 20 6d 6f 75  NAME.appfsd, mou
0040: 6e 74 2e 61 70 70 66 73 20 2d 20 41 70 70 46 53  nt.appfs - AppFS
0050: 20 46 55 53 45 20 44 61 65 6d 6f 6e 0a 0a 2e 53   FUSE Daemon...S
0060: 48 20 53 59 4e 4f 50 53 49 53 0a 2e 42 49 20 22  H SYNOPSIS..BI "
0070: 61 70 70 66 73 64 20 5b 5c 2d 64 66 73 68 5d 20  appfsd [\-dfsh] 
0080: 5b 5c 2d 6f 20 22 20 6f 70 74 69 6f 6e 20 22 5b  [\-o " option "[
0090: 2c 22 20 2e 2e 2e 20 22 5d 5d 20 22 20 63 61 63  ," ... "]] " cac
00a0: 68 65 64 69 72 20 22 20 22 20 6d 6f 75 6e 74 5f  hedir " " mount_
00b0: 70 6f 69 6e 74 0a 2e 62 72 0a 2e 42 49 20 22 6d  point..br..BI "m
00c0: 6f 75 6e 74 2e 61 70 70 66 73 20 5b 5c 2d 64 66  ount.appfs [\-df
00d0: 73 68 5d 20 5b 5c 2d 6f 20 22 20 6f 70 74 69 6f  sh] [\-o " optio
00e0: 6e 20 22 5b 2c 22 20 2e 2e 2e 20 22 5d 5d 20 22  n "[," ... "]] "
00f0: 20 63 61 63 68 65 64 69 72 20 22 20 22 20 6d 6f   cachedir " " mo
0100: 75 6e 74 5f 70 6f 69 6e 74 0a 0a 2e 53 48 20 44  unt_point...SH D
0110: 45 53 43 52 49 50 54 49 4f 4e 0a 41 70 70 46 53  ESCRIPTION.AppFS
0120: 20 69 73 20 61 20 46 55 53 45 2d 62 61 73 65 64   is a FUSE-based
0130: 20 66 69 6c 65 73 79 73 74 65 6d 20 74 6f 20 70   filesystem to p
0140: 72 65 73 65 6e 74 20 61 20 6d 61 6e 69 66 65 73  resent a manifes
0150: 74 2d 62 61 73 65 64 20 70 61 63 6b 61 67 65 20  t-based package 
0160: 66 6f 72 6d 61 74 0a 66 72 6f 6d 20 72 65 6d 6f  format.from remo
0170: 74 65 20 73 65 72 76 65 72 73 20 74 6f 20 74 68  te servers to th
0180: 65 20 6c 6f 63 61 6c 20 73 79 73 74 65 6d 2e 20  e local system. 
0190: 20 49 74 20 77 6f 72 6b 73 20 6f 76 65 72 20 48   It works over H
01a0: 54 54 50 20 28 62 79 20 64 65 66 61 75 6c 74 2c  TTP (by default,
01b0: 0a 61 74 20 6c 65 61 73 74 29 2e 20 20 52 65 6d  .at least).  Rem
01c0: 6f 74 65 20 73 69 74 65 73 20 61 72 65 20 69 64  ote sites are id
01d0: 65 6e 74 69 66 69 65 64 20 61 74 20 74 68 65 20  entified at the 
01e0: 74 6f 70 2d 6c 65 76 65 6c 20 6f 66 20 74 68 65  top-level of the
01f0: 20 6d 6f 75 6e 74 65 64 0a 64 69 72 65 63 74 6f   mounted.directo
0200: 72 79 20 61 6e 64 20 61 6c 6c 20 73 69 74 65 73  ry and all sites
0210: 20 61 72 65 20 76 65 72 69 66 69 65 64 20 62 79   are verified by
0220: 20 50 4b 49 20 73 69 67 6e 61 74 75 72 65 2e 0a   PKI signature..
0230: 0a 41 70 70 46 53 20 69 73 20 73 74 61 72 74 65  .AppFS is starte
0240: 64 20 77 69 74 68 20 74 68 65 20 5c 66 42 61 70  d with the \fBap
0250: 70 66 73 64 5c 66 52 20 64 61 65 6d 6f 6e 2c 20  pfsd\fR daemon, 
0260: 77 68 69 63 68 20 6d 61 79 20 61 6c 73 6f 20 62  which may also b
0270: 65 20 6e 61 6d 65 64 0a 5c 66 42 6d 6f 75 6e 74  e named.\fBmount
0280: 2e 61 70 70 66 73 5c 66 52 2e 0a 0a 2e 53 48 20  .appfs\fR....SH 
0290: 4f 50 54 49 4f 4e 53 0a 2e 54 50 20 0a 2e 42 52  OPTIONS..TP ..BR
02a0: 20 5c 2d 64 0a 45 6e 61 62 6c 65 20 46 55 53 45   \-d.Enable FUSE
02b0: 20 64 65 62 75 67 20 6d 6f 64 65 2e 20 0a 0a 2e   debug mode. ...
02c0: 54 50 0a 2e 42 20 5c 2d 66 0a 52 75 6e 20 41 70  TP..B \-f.Run Ap
02d0: 70 46 53 20 64 61 65 6d 6f 6e 20 69 6e 20 74 68  pFS daemon in th
02e0: 65 20 66 6f 72 65 67 72 6f 75 6e 64 2e 0a 0a 2e  e foreground....
02f0: 54 50 0a 2e 42 20 5c 2d 73 0a 45 6e 61 62 6c 65  TP..B \-s.Enable
0300: 20 73 69 6e 67 6c 65 20 74 68 72 65 61 64 65 64   single threaded
0310: 20 6d 6f 64 65 2e 20 20 54 68 69 73 20 77 69 6c   mode.  This wil
0320: 6c 20 73 69 67 6e 69 66 69 63 61 6e 74 6c 79 20  l significantly 
0330: 72 65 64 75 63 65 20 70 65 72 66 6f 72 6d 61 6e  reduce performan
0340: 63 65 20 61 6e 64 0a 72 65 73 70 6f 6e 73 69 76  ce and.responsiv
0350: 65 6e 65 73 73 2e 0a 0a 2e 54 50 0a 2e 42 20 5c  eness....TP..B \
0360: 2d 68 0a 52 65 71 75 65 73 74 20 75 73 61 67 65  -h.Request usage
0370: 20 68 65 6c 70 2e 0a 0a 2e 54 50 0a 2e 42 20 22   help....TP..B "
0380: 5c 2d 6f 20 6e 6f 74 68 72 65 61 64 73 22 0a 45  \-o nothreads".E
0390: 6e 61 62 6c 65 20 73 69 6e 67 6c 65 20 74 68 72  nable single thr
03a0: 65 61 64 65 64 20 6d 6f 64 65 2e 20 20 54 68 69  eaded mode.  Thi
03b0: 73 20 77 69 6c 6c 20 73 69 67 6e 69 66 69 63 61  s will significa
03c0: 6e 74 6c 79 20 72 65 64 75 63 65 20 70 65 72 66  ntly reduce perf
03d0: 6f 72 6d 61 6e 63 65 20 61 6e 64 0a 72 65 73 70  ormance and.resp
03e0: 6f 6e 73 69 76 65 6e 65 73 73 2e 0a 54 68 69 73  onsiveness..This
03f0: 20 69 73 20 74 68 65 20 73 61 6d 65 20 61 73 20   is the same as 
0400: 74 68 65 20 22 5c 66 42 2d 73 5c 66 52 22 20 6f  the "\fB-s\fR" o
0410: 70 74 69 6f 6e 2c 20 70 72 6f 76 69 64 65 64 20  ption, provided 
0420: 66 6f 72 20 75 73 65 20 69 6e 20 61 6e 0a 5c 66  for use in an.\f
0430: 49 2f 65 74 63 2f 66 73 74 61 62 5c 66 52 20 6f  I/etc/fstab\fR o
0440: 70 74 69 6f 6e 2e 0a 0a 2e 54 50 0a 2e 42 20 22  ption....TP..B "
0450: 5c 2d 6f 20 61 6c 6c 6f 77 5f 6f 74 68 65 72 22  \-o allow_other"
0460: 0a 41 6c 6c 6f 77 20 6f 74 68 65 72 20 75 73 65  .Allow other use
0470: 72 73 20 74 6f 20 61 63 63 65 73 73 20 74 68 69  rs to access thi
0480: 73 20 6d 6f 75 6e 74 70 6f 69 6e 74 20 28 74 68  s mountpoint (th
0490: 69 73 20 69 73 20 74 68 65 20 64 65 66 61 75 6c  is is the defaul
04a0: 74 20 69 66 20 74 68 65 20 75 73 65 72 0a 72 75  t if the user.ru
04b0: 6e 6e 69 6e 67 20 5c 66 42 61 70 70 66 73 64 5c  nning \fBappfsd\
04c0: 66 52 20 69 73 20 72 6f 6f 74 29 2e 0a 0a 2e 54  fR is root)....T
04d0: 50 0a 2e 49 20 63 61 63 68 65 64 69 72 0a 50 61  P..I cachedir.Pa
04e0: 74 68 20 74 6f 20 61 20 64 69 72 65 63 74 6f 72  th to a director
04f0: 79 20 74 6f 20 73 74 6f 72 65 20 63 61 63 68 65  y to store cache
0500: 20 64 61 74 61 62 61 73 65 20 61 6e 64 20 72 65   database and re
0510: 61 64 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e  ad configuration
0520: 20 66 69 6c 65 20 66 72 6f 6d 2e 0a 41 20 73 75   file from..A su
0530: 67 67 65 73 74 65 64 20 76 61 6c 75 65 20 66 6f  ggested value fo
0540: 72 20 74 68 69 73 20 66 6f 72 20 61 20 73 79 73  r this for a sys
0550: 74 65 6d 2d 77 69 64 65 20 5c 66 42 61 70 70 66  tem-wide \fBappf
0560: 73 64 5c 66 52 20 69 73 0a 5c 66 49 2f 76 61 72  sd\fR is.\fI/var
0570: 2f 63 61 63 68 65 2f 61 70 70 66 73 5c 66 52 2e  /cache/appfs\fR.
0580: 0a 0a 2e 54 50 0a 2e 49 20 6d 6f 75 6e 74 5f 70  ...TP..I mount_p
0590: 6f 69 6e 74 0a 50 61 74 68 20 74 6f 20 6d 6f 75  oint.Path to mou
05a0: 6e 74 20 41 70 70 46 53 20 6f 6e 74 6f 20 69 6e  nt AppFS onto in
05b0: 20 74 68 65 20 66 69 6c 65 73 79 73 74 65 6d 2e   the filesystem.
05c0: 20 20 54 68 69 73 20 73 68 6f 75 6c 64 20 61 6c    This should al
05d0: 6d 6f 73 74 20 61 6c 77 61 79 73 20 62 65 0a 5c  most always be.\
05e0: 66 49 2f 6f 70 74 2f 61 70 70 66 73 5c 66 52 2e  fI/opt/appfs\fR.
05f0: 0a 0a 2e 53 48 20 46 49 4c 45 53 0a 2e 54 50 0a  ...SH FILES..TP.
0600: 2e 49 42 20 63 61 63 68 65 64 69 72 20 2f 63 6f  .IB cachedir /co
0610: 6e 66 69 67 0a 43 6f 6e 66 69 67 75 72 61 74 69  nfig.Configurati
0620: 6f 6e 20 66 69 6c 65 20 66 6f 72 20 74 68 69 73  on file for this
0630: 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 41 70 70   instance of App
0640: 46 53 2e 20 20 54 68 69 73 20 73 68 6f 75 6c 64  FS.  This should
0650: 20 62 65 20 61 20 76 61 6c 69 64 0a 2e 42 52 20   be a valid..BR 
0660: 54 63 6c 20 28 6e 29 0a 73 63 72 69 70 74 2e 20  Tcl (n).script. 
0670: 20 54 68 65 20 63 6f 6e 66 69 67 75 72 61 74 69   The configurati
0680: 6f 6e 20 66 69 6c 65 20 63 61 6e 20 62 65 20 6d  on file can be m
0690: 6f 64 69 66 69 65 64 20 61 74 20 72 75 6e 2d 74  odified at run-t
06a0: 69 6d 65 20 61 6e 64 20 5c 66 42 61 70 70 66 73  ime and \fBappfs
06b0: 64 5c 66 52 0a 72 65 6c 6f 61 64 65 64 20 62 79  d\fR.reloaded by
06c0: 20 73 65 6e 64 69 6e 67 20 69 74 20 61 20 5c 66   sending it a \f
06d0: 42 53 49 47 48 55 50 5c 66 52 2e 0a 0a 2e 54 50  BSIGHUP\fR....TP
06e0: 0a 2e 49 42 20 63 61 63 68 65 64 69 72 20 2f 63  ..IB cachedir /c
06f0: 61 63 68 65 2e 64 62 0a 53 51 4c 69 74 65 33 20  ache.db.SQLite3 
0700: 64 61 74 61 62 61 73 65 20 75 73 65 64 20 66 6f  database used fo
0710: 72 20 6d 61 69 6e 74 61 69 6e 69 6e 67 20 6d 65  r maintaining me
0720: 74 61 64 61 74 61 20 66 6f 72 20 74 68 65 20 63  tadata for the c
0730: 61 63 68 65 20 64 69 72 65 63 74 6f 72 79 2e 0a  ache directory..
0740: 0a 2e 53 48 20 45 58 41 4d 50 4c 45 53 0a 54 68  ..SH EXAMPLES.Th
0750: 65 20 6d 6f 73 74 20 72 65 63 6f 6d 6d 65 6e 64  e most recommend
0760: 65 64 20 6d 65 74 68 6f 64 20 6f 66 20 72 75 6e  ed method of run
0770: 6e 69 6e 67 20 41 70 70 46 53 20 28 64 69 72 65  ning AppFS (dire
0780: 63 74 6c 79 29 3a 0a 2e 50 50 0a 2e 6e 66 0a 2e  ctly):..PP..nf..
0790: 52 53 0a 23 20 6d 6b 64 69 72 20 2f 6f 70 74 2f  RS.# mkdir /opt/
07a0: 61 70 70 66 73 0a 23 20 61 70 70 66 73 64 20 2f  appfs.# appfsd /
07b0: 76 61 72 2f 63 61 63 68 65 2f 61 70 70 66 73 20  var/cache/appfs 
07c0: 2f 6f 70 74 2f 61 70 70 66 73 0a 2e 52 45 0a 2e  /opt/appfs..RE..
07d0: 66 69 0a 0a 43 72 65 61 74 65 20 61 6e 20 5c 66  fi..Create an \f
07e0: 49 2f 65 74 63 2f 66 73 74 61 62 5c 66 52 20 65  I/etc/fstab\fR e
07f0: 6e 74 72 79 3a 0a 2e 50 50 0a 2e 6e 66 0a 2e 52  ntry:..PP..nf..R
0800: 53 0a 2f 76 61 72 2f 63 61 63 68 65 2f 61 70 70  S./var/cache/app
0810: 66 73 20 2f 6f 70 74 2f 61 70 70 66 73 20 20 20  fs /opt/appfs   
0820: 20 20 20 20 61 70 70 66 73 20 20 20 20 20 20 20      appfs       
0830: 64 65 66 61 75 6c 74 73 20 20 20 20 20 20 20 20  defaults        
0840: 20 30 20 20 20 30 0a 2e 52 45 0a 2e 66 69 0a 0a   0   0..RE..fi..
0850: 2e 53 48 20 53 45 45 20 41 4c 53 4f 0a 2e 42 52  .SH SEE ALSO..BR
0860: 20 54 63 6c 20 28 6e 29 20 2c 0a 2e 42 52 20 73   Tcl (n) ,..BR s
0870: 71 6c 69 74 65 33 20 28 31 29 0a                 qlite3 (1).