Hex Artifact Content

Artifact 93dadcba78974e4c8e0dba52e9b555ed993c083d:


0000: 2e 50 55 0a 2e 54 48 20 46 49 4c 45 44 20 31 20  .PU..TH FILED 1 
0010: 22 31 32 20 46 65 62 20 31 34 22 20 22 66 69 6c  "12 Feb 14" "fil
0020: 65 64 20 31 2e 36 22 0a 2e 53 48 20 4e 41 4d 45  ed 1.6"..SH NAME
0030: 0a 66 69 6c 65 64 20 5c 2d 20 73 65 72 76 65 20  .filed \- serve 
0040: 66 69 6c 65 73 20 6f 76 65 72 20 48 54 54 50 0a  files over HTTP.
0050: 2e 53 48 20 53 59 4e 4f 50 53 49 53 0a 2e 6c 6c  .SH SYNOPSIS..ll
0060: 20 2b 31 30 0a 2e 42 20 66 69 6c 65 64 0a 2e 52   +10..B filed..R
0070: 42 20 5b 7b 20 5c 2d 68 20 7c 20 5c 2d 5c 2d 68  B [{ \-h | \-\-h
0080: 65 6c 70 20 7d 5d 0a 2e 52 42 20 5b 7b 20 5c 2d  elp }]..RB [{ \-
0090: 64 20 7c 20 5c 2d 5c 2d 64 61 65 6d 6f 6e 20 7d  d | \-\-daemon }
00a0: 5d 0a 2e 52 42 20 5b 7b 20 5c 2d 76 20 7c 20 5c  ]..RB [{ \-v | \
00b0: 2d 5c 2d 76 65 72 73 69 6f 6e 20 7d 5d 0a 2e 52  -\-version }]..R
00c0: 42 20 5b 7b 20 5c 2d 62 20 7c 20 5c 2d 5c 2d 62  B [{ \-b | \-\-b
00d0: 69 6e 64 20 7d 0a 2e 49 52 20 61 64 64 72 65 73  ind }..IR addres
00e0: 73 20 5d 0a 2e 52 42 20 5b 7b 20 5c 2d 70 20 7c  s ]..RB [{ \-p |
00f0: 20 5c 2d 5c 2d 70 6f 72 74 20 7d 0a 2e 49 52 20   \-\-port }..IR 
0100: 70 6f 72 74 20 5d 0a 2e 52 42 20 5b 7b 20 5c 2d  port ]..RB [{ \-
0110: 74 20 7c 20 5c 2d 5c 2d 74 68 72 65 61 64 73 20  t | \-\-threads 
0120: 7d 0a 2e 49 52 20 63 6f 75 6e 74 20 5d 0a 2e 52  }..IR count ]..R
0130: 42 20 5b 7b 20 5c 2d 63 20 7c 20 5c 2d 5c 2d 63  B [{ \-c | \-\-c
0140: 61 63 68 65 20 7d 0a 2e 49 52 20 65 6e 74 72 69  ache }..IR entri
0150: 65 73 20 5d 0a 2e 52 42 20 5b 7b 20 5c 2d 6c 20  es ]..RB [{ \-l 
0160: 7c 20 5c 2d 5c 2d 6c 6f 67 20 7d 0a 2e 49 52 20  | \-\-log }..IR 
0170: 66 69 6c 65 20 5d 0a 2e 52 42 20 5b 7b 20 5c 2d  file ]..RB [{ \-
0180: 75 20 7c 20 5c 2d 5c 2d 75 73 65 72 20 7d 0a 2e  u | \-\-user }..
0190: 49 52 20 75 73 65 72 20 5d 0a 2e 52 42 20 5b 7b  IR user ]..RB [{
01a0: 20 5c 2d 72 20 7c 20 5c 2d 5c 2d 72 6f 6f 74 20   \-r | \-\-root 
01b0: 7d 0a 2e 49 52 20 64 69 72 65 63 74 6f 72 79 20  }..IR directory 
01c0: 5d 0a 0a 2e 6c 6c 20 2d 31 30 0a 2e 53 48 20 44  ]...ll -10..SH D
01d0: 45 53 43 52 49 50 54 49 4f 4e 0a 2e 49 20 46 49  ESCRIPTION..I FI
01e0: 4c 45 44 0a 73 65 72 76 65 73 20 66 69 6c 65 73  LED.serves files
01f0: 20 6f 76 65 72 20 48 54 54 50 20 61 73 20 6d 69   over HTTP as mi
0200: 6e 69 6d 61 6c 6c 79 20 61 73 20 70 6f 73 73 69  nimally as possi
0210: 62 6c 65 2e 20 20 4f 6e 6c 79 20 73 74 61 74 69  ble.  Only stati
0220: 63 20 66 69 6c 65 73 20 28 69 2e 65 2e 2c 20 66  c files (i.e., f
0230: 69 6c 65 73 20 74 68 61 74 20 6e 65 76 65 72 20  iles that never 
0240: 63 68 61 6e 67 65 20 6f 72 20 61 72 65 20 72 65  change or are re
0250: 70 6c 61 63 65 64 29 20 61 72 65 20 73 75 70 70  placed) are supp
0260: 6f 72 74 65 64 2e 0a 0a 2e 53 48 20 4f 50 54 49  orted....SH OPTI
0270: 4f 4e 53 0a 2e 54 50 0a 2e 42 20 2d 68 20 28 6f  ONS..TP..B -h (o
0280: 72 20 2d 2d 68 65 6c 70 29 0a 50 72 69 6e 74 73  r --help).Prints
0290: 20 64 65 74 61 69 6c 65 64 20 75 73 61 67 65 20   detailed usage 
02a0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 0a 2e 54  information....T
02b0: 50 0a 2e 42 20 2d 64 20 28 6f 72 20 2d 2d 64 61  P..B -d (or --da
02c0: 65 6d 6f 6e 29 0a 49 6e 73 74 72 75 63 74 73 0a  emon).Instructs.
02d0: 2e 42 20 66 69 6c 65 64 0a 74 6f 20 62 65 63 6f  .B filed.to beco
02e0: 6d 65 20 61 20 64 61 65 6d 6f 6e 20 61 66 74 65  me a daemon afte
02f0: 72 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 0a 74  r initializing.t
0300: 68 65 20 6c 69 73 74 65 6e 69 6e 67 20 54 43 50  he listening TCP
0310: 20 73 6f 63 6b 65 74 20 61 6e 64 20 6c 6f 67 20   socket and log 
0320: 66 69 6c 65 73 2e 0a 0a 2e 54 50 0a 2e 42 20 2d  files....TP..B -
0330: 76 20 28 6f 72 20 2d 2d 76 65 72 73 69 6f 6e 29  v (or --version)
0340: 0a 49 6e 73 74 72 75 63 74 73 0a 2e 42 20 66 69  .Instructs..B fi
0350: 6c 65 64 0a 74 6f 20 70 72 69 6e 74 20 6f 75 74  led.to print out
0360: 20 69 74 73 20 76 65 72 73 69 6f 6e 20 6e 75 6d   its version num
0370: 62 65 72 20 61 6e 64 20 74 68 65 6e 20 65 78 69  ber and then exi
0380: 74 2e 0a 0a 2e 54 50 0a 2e 42 20 2d 62 20 28 6f  t....TP..B -b (o
0390: 72 20 2d 2d 62 69 6e 64 29 0a 53 70 65 63 69 66  r --bind).Specif
03a0: 69 65 73 20 74 68 65 20 61 64 64 72 65 73 73 20  ies the address 
03b0: 74 6f 20 6c 69 73 74 65 6e 20 66 6f 72 20 69 6e  to listen for in
03c0: 63 6f 6d 69 6e 67 20 48 54 54 50 0a 72 65 71 75  coming HTTP.requ
03d0: 65 73 74 73 20 6f 6e 2e 0a 0a 2e 54 50 0a 2e 42  ests on....TP..B
03e0: 20 2d 70 20 28 6f 72 20 2d 2d 70 6f 72 74 29 0a   -p (or --port).
03f0: 53 70 65 63 69 66 69 65 73 20 74 68 65 20 54 43  Specifies the TC
0400: 50 20 70 6f 72 74 20 6e 75 6d 62 65 72 20 74 6f  P port number to
0410: 20 6c 69 73 74 65 6e 20 66 6f 72 20 69 6e 63 6f   listen for inco
0420: 6d 69 6e 67 20 48 54 54 50 0a 72 65 71 75 65 73  ming HTTP.reques
0430: 74 73 20 6f 6e 2e 0a 0a 2e 54 50 0a 2e 42 20 2d  ts on....TP..B -
0440: 74 20 28 6f 72 20 2d 2d 74 68 72 65 61 64 73 29  t (or --threads)
0450: 0a 53 70 65 63 69 66 69 65 73 20 74 68 65 20 6e  .Specifies the n
0460: 75 6d 62 65 72 20 6f 66 20 77 6f 72 6b 65 72 20  umber of worker 
0470: 74 68 72 65 61 64 73 20 74 6f 20 63 72 65 61 74  threads to creat
0480: 65 2e 20 45 61 63 68 0a 77 6f 72 6b 65 72 20 74  e. Each.worker t
0490: 68 72 65 61 64 20 63 61 6e 20 73 65 72 76 69 63  hread can servic
04a0: 65 20 6f 6e 65 20 63 6f 6e 63 75 72 72 65 6e 74  e one concurrent
04b0: 20 48 54 54 50 20 73 65 73 73 69 6f 6e 2e 0a 54   HTTP session..T
04c0: 68 75 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  hus the number o
04d0: 66 20 74 68 72 65 61 64 73 20 63 72 65 61 74 65  f threads create
04e0: 64 20 77 69 6c 6c 20 64 65 74 65 72 6d 69 6e 65  d will determine
04f0: 20 68 6f 77 0a 6d 61 6e 79 20 73 69 6d 75 6c 74   how.many simult
0500: 61 6e 65 6f 75 73 20 74 72 61 6e 73 66 65 72 73  aneous transfers
0510: 20 77 69 6c 6c 20 62 65 20 70 6f 73 73 69 62 6c   will be possibl
0520: 65 2e 0a 0a 2e 54 50 0a 2e 42 20 2d 63 20 28 6f  e....TP..B -c (o
0530: 72 20 2d 2d 63 61 63 68 65 29 0a 53 70 65 63 69  r --cache).Speci
0540: 66 69 65 73 20 74 68 65 20 6e 75 6d 62 65 72 20  fies the number 
0550: 6f 66 20 66 69 6c 65 20 69 6e 66 6f 72 6d 61 74  of file informat
0560: 69 6f 6e 20 63 61 63 68 65 20 65 6e 74 72 69 65  ion cache entrie
0570: 73 0a 74 6f 20 61 6c 6c 6f 63 61 74 65 2e 20 20  s.to allocate.  
0580: 45 61 63 68 20 63 61 63 68 65 20 65 6e 74 72 79  Each cache entry
0590: 20 68 6f 6c 64 73 20 66 69 6c 65 20 69 6e 66 6f   holds file info
05a0: 72 6d 61 74 69 6f 6e 20 61 73 0a 77 65 6c 6c 20  rmation as.well 
05b0: 61 73 20 61 6e 20 6f 70 65 6e 20 66 69 6c 65 20  as an open file 
05c0: 64 65 73 63 72 69 70 74 6f 72 20 74 6f 20 74 68  descriptor to th
05d0: 65 20 66 69 6c 65 2c 20 73 6f 20 72 65 73 6f 75  e file, so resou
05e0: 72 63 65 0a 6c 69 6d 69 74 73 20 28 69 2e 65 2e  rce.limits (i.e.
05f0: 2c 20 75 6c 69 6d 69 74 29 20 73 68 6f 75 6c 64  , ulimit) should
0600: 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 2e 20   be considered. 
0610: 20 54 68 69 73 20 73 68 6f 75 6c 64 0a 62 65 20   This should.be 
0620: 61 20 70 72 69 6d 65 20 6e 75 6d 62 65 72 20 66  a prime number f
0630: 6f 72 20 69 64 65 61 6c 20 75 73 65 20 77 69 74  or ideal use wit
0640: 68 20 74 68 65 20 6c 6f 6f 6b 75 70 20 6d 65 74  h the lookup met
0650: 68 6f 64 2e 0a 0a 2e 54 50 0a 2e 42 20 2d 6c 20  hod....TP..B -l 
0660: 28 6f 72 20 2d 2d 6c 6f 67 29 0a 53 70 65 63 69  (or --log).Speci
0670: 66 69 65 73 20 61 20 66 69 6c 65 6e 61 6d 65 20  fies a filename 
0680: 74 6f 20 6f 70 65 6e 20 66 6f 72 20 77 72 69 74  to open for writ
0690: 69 6e 67 20 6c 6f 67 20 65 6e 74 72 69 65 73 2e  ing log entries.
06a0: 20 20 4c 6f 67 0a 65 6e 74 72 69 65 73 20 61 72    Log.entries ar
06b0: 65 20 6d 61 64 65 20 66 6f 72 20 76 61 72 69 6f  e made for vario
06c0: 75 73 20 73 74 61 67 65 73 20 69 6e 20 74 72 61  us stages in tra
06d0: 6e 73 66 65 72 69 6e 67 20 66 69 6c 65 73 2e 0a  nsfering files..
06e0: 54 68 65 20 6c 6f 67 20 66 69 6c 65 20 69 73 20  The log file is 
06f0: 6f 70 65 6e 65 64 20 62 65 66 6f 72 65 20 73 77  opened before sw
0700: 69 74 63 68 69 6e 67 20 75 73 65 72 73 20 28 73  itching users (s
0710: 65 65 20 22 2d 75 22 29 0a 61 6e 64 20 72 6f 6f  ee "-u").and roo
0720: 74 20 64 69 72 65 63 74 6f 72 69 65 73 20 28 73  t directories (s
0730: 65 65 20 22 2d 72 22 29 2e 20 20 54 68 65 20 6c  ee "-r").  The l
0740: 6f 67 20 66 69 6c 65 20 69 73 20 6e 65 76 65 72  og file is never
0750: 0a 63 6c 6f 73 65 64 20 73 6f 20 6c 6f 67 20 72  .closed so log r
0760: 6f 74 61 74 69 6f 6e 20 77 69 74 68 6f 75 74 20  otation without 
0770: 73 74 6f 70 70 69 6e 67 20 74 68 65 20 64 61 65  stopping the dae
0780: 6d 6f 6e 20 69 73 20 77 69 6c 6c 0a 6e 6f 74 20  mon is will.not 
0790: 77 6f 72 6b 2e 20 20 54 68 65 20 76 61 6c 75 65  work.  The value
07a0: 20 6f 66 20 22 2d 22 20 69 6e 64 69 63 61 74 65   of "-" indicate
07b0: 73 20 74 68 61 74 20 73 74 61 6e 64 61 72 64 20  s that standard 
07c0: 6f 75 74 70 75 74 0a 73 68 6f 75 6c 64 20 62 65  output.should be
07d0: 20 75 73 65 64 20 66 6f 72 20 6c 6f 67 67 69 6e   used for loggin
07e0: 67 2e 20 20 49 66 20 74 68 65 20 66 69 6c 65 6e  g.  If the filen
07f0: 61 6d 65 20 62 65 67 69 6e 73 20 77 69 74 68 20  ame begins with 
0800: 61 0a 70 69 70 65 20 28 22 7c 22 29 20 74 68 65  a.pipe ("|") the
0810: 6e 20 61 20 70 72 6f 63 65 73 73 20 69 73 20 73  n a process is s
0820: 74 61 72 74 65 64 20 61 6e 64 20 75 73 65 64 20  tarted and used 
0830: 66 6f 72 20 6c 6f 67 67 69 6e 67 0a 69 6e 73 74  for logging.inst
0840: 65 61 64 20 6f 66 20 61 20 66 69 6c 65 2e 0a 0a  ead of a file...
0850: 2e 54 50 0a 2e 42 20 2d 75 20 28 6f 72 20 2d 2d  .TP..B -u (or --
0860: 75 73 65 72 29 0a 53 70 65 63 69 66 69 65 73 20  user).Specifies 
0870: 74 68 65 20 75 73 65 72 20 74 6f 20 73 77 69 74  the user to swit
0880: 63 68 20 75 73 65 72 20 49 44 73 20 74 6f 20 62  ch user IDs to b
0890: 65 66 6f 72 65 20 73 65 72 76 69 63 69 6e 67 0a  efore servicing.
08a0: 72 65 71 75 65 73 74 73 2e 20 20 54 68 65 20 64  requests.  The d
08b0: 65 66 61 75 6c 74 20 69 73 20 6e 6f 74 20 63 68  efault is not ch
08c0: 61 6e 67 65 20 75 73 65 72 20 49 44 73 2e 0a 0a  ange user IDs...
08d0: 2e 54 50 0a 2e 42 20 2d 72 20 28 6f 72 20 2d 2d  .TP..B -r (or --
08e0: 72 6f 6f 74 29 0a 53 70 65 63 69 66 69 65 73 20  root).Specifies 
08f0: 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 74 6f  the directory to
0900: 20 61 63 74 20 61 73 20 74 68 65 20 72 6f 6f 74   act as the root
0910: 20 64 69 72 65 63 74 6f 72 79 20 66 6f 72 0a 74   directory for.t
0920: 68 65 20 66 69 6c 65 20 73 65 72 76 65 72 2e 20  he file server. 
0930: 20 49 66 20 74 68 69 73 20 6f 70 74 69 6f 6e 20   If this option 
0940: 69 73 20 73 70 65 63 69 66 69 65 64 2c 20 63 68  is specified, ch
0950: 72 6f 6f 74 28 32 29 0a 69 73 20 63 61 6c 6c 65  root(2).is calle
0960: 64 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74 20  d.  The default 
0970: 69 73 20 6e 6f 74 20 63 68 61 6e 67 65 20 72 6f  is not change ro
0980: 6f 74 20 64 69 72 65 63 74 6f 72 69 65 73 2c 0a  ot directories,.
0990: 74 68 61 74 20 69 73 2c 20 74 68 65 20 22 2f 22  that is, the "/"
09a0: 20 64 69 72 65 63 74 6f 72 79 20 69 73 20 73 68   directory is sh
09b0: 61 72 65 64 20 6f 75 74 2e 20 20 54 68 69 73 20  ared out.  This 
09c0: 77 69 6c 6c 0a 6c 69 6b 65 6c 79 20 62 65 20 61  will.likely be a
09d0: 20 73 65 63 75 72 69 74 79 20 69 73 73 75 65 2c   security issue,
09e0: 20 73 6f 20 74 68 69 73 20 6f 70 74 69 6f 6e 20   so this option 
09f0: 73 68 6f 75 6c 64 20 61 6c 77 61 79 73 0a 62 65  should always.be
0a00: 20 75 73 65 64 2e 0a 0a 2e 53 48 20 41 55 54 48   used....SH AUTH
0a10: 4f 52 0a 2e 53 70 0a 52 6f 79 20 4b 65 65 6e 65  OR..Sp.Roy Keene
0a20: 0a 2e 49 20 3c 66 69 6c 65 64 40 72 6b 65 65 6e  ..I <filed@rkeen
0a30: 65 2e 6f 72 67 3e 0a                             e.org>.