Hex Artifact Content

Artifact 368e134ee9c38908ccf1295af5e151531b83b480:


0000: 2e 50 55 0a 2e 54 48 20 46 49 4c 45 44 20 31 20  .PU..TH FILED 1 
0010: 22 30 36 20 46 65 62 20 31 34 22 20 22 66 69 6c  "06 Feb 14" "fil
0020: 65 64 20 31 2e 30 22 0a 2e 53 48 20 4e 41 4d 45  ed 1.0"..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 62 20 7c 20 5c  ]..RB [{ \-b | \
00b0: 2d 5c 2d 62 69 6e 64 20 7d 0a 2e 49 52 20 61 64  -\-bind }..IR ad
00c0: 64 72 65 73 73 20 5d 0a 2e 52 42 20 5b 7b 20 5c  dress ]..RB [{ \
00d0: 2d 70 20 7c 20 5c 2d 5c 2d 70 6f 72 74 20 7d 0a  -p | \-\-port }.
00e0: 2e 49 52 20 70 6f 72 74 20 5d 0a 2e 52 42 20 5b  .IR port ]..RB [
00f0: 7b 20 5c 2d 74 20 7c 20 5c 2d 5c 2d 74 68 72 65  { \-t | \-\-thre
0100: 61 64 73 20 7d 0a 2e 49 52 20 63 6f 75 6e 74 20  ads }..IR count 
0110: 5d 0a 2e 52 42 20 5b 7b 20 5c 2d 63 20 7c 20 5c  ]..RB [{ \-c | \
0120: 2d 5c 2d 63 61 63 68 65 20 7d 0a 2e 49 52 20 65  -\-cache }..IR e
0130: 6e 74 72 69 65 73 20 5d 0a 2e 52 42 20 5b 7b 20  ntries ]..RB [{ 
0140: 5c 2d 6c 20 7c 20 5c 2d 5c 2d 6c 6f 67 20 7d 0a  \-l | \-\-log }.
0150: 2e 49 52 20 66 69 6c 65 20 5d 0a 2e 52 42 20 5b  .IR file ]..RB [
0160: 7b 20 5c 2d 75 20 7c 20 5c 2d 5c 2d 75 73 65 72  { \-u | \-\-user
0170: 20 7d 0a 2e 49 52 20 75 73 65 72 20 5d 0a 2e 52   }..IR user ]..R
0180: 42 20 5b 7b 20 5c 2d 72 20 7c 20 5c 2d 5c 2d 72  B [{ \-r | \-\-r
0190: 6f 6f 74 20 7d 0a 2e 49 52 20 64 69 72 65 63 74  oot }..IR direct
01a0: 6f 72 79 20 5d 0a 0a 2e 6c 6c 20 2d 31 30 0a 2e  ory ]...ll -10..
01b0: 53 48 20 44 45 53 43 52 49 50 54 49 4f 4e 0a 2e  SH DESCRIPTION..
01c0: 49 20 46 49 4c 45 44 0a 73 65 72 76 65 73 20 66  I FILED.serves f
01d0: 69 6c 65 73 20 6f 76 65 72 20 48 54 54 50 20 61  iles over HTTP a
01e0: 73 20 6d 69 6e 69 6d 61 6c 6c 79 20 61 73 20 70  s minimally as p
01f0: 6f 73 73 69 62 6c 65 2e 20 20 4f 6e 6c 79 20 73  ossible.  Only s
0200: 74 61 74 69 63 20 66 69 6c 65 73 20 28 69 2e 65  tatic files (i.e
0210: 2e 2c 20 66 69 6c 65 73 20 74 68 61 74 20 6e 65  ., files that ne
0220: 76 65 72 20 63 68 61 6e 67 65 20 6f 72 20 61 72  ver change or ar
0230: 65 20 72 65 70 6c 61 63 65 64 29 20 61 72 65 20  e replaced) are 
0240: 73 75 70 70 6f 72 74 65 64 2e 0a 0a 2e 53 48 20  supported....SH 
0250: 4f 50 54 49 4f 4e 53 0a 2e 54 50 0a 2e 42 20 2d  OPTIONS..TP..B -
0260: 68 20 28 6f 72 20 2d 2d 68 65 6c 70 29 0a 50 72  h (or --help).Pr
0270: 69 6e 74 73 20 64 65 74 61 69 6c 65 64 20 75 73  ints detailed us
0280: 61 67 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e  age information.
0290: 0a 0a 2e 54 50 0a 2e 42 20 2d 64 20 28 6f 72 20  ...TP..B -d (or 
02a0: 2d 2d 64 61 65 6d 6f 6e 29 0a 49 6e 73 74 72 75  --daemon).Instru
02b0: 63 74 73 0a 2e 42 20 66 69 6c 65 64 0a 74 6f 20  cts..B filed.to 
02c0: 62 65 63 6f 6d 65 20 61 20 64 61 65 6d 6f 6e 20  become a daemon 
02d0: 61 66 74 65 72 20 69 6e 69 74 69 61 6c 69 7a 69  after initializi
02e0: 6e 67 0a 74 68 65 20 6c 69 73 74 65 6e 69 6e 67  ng.the listening
02f0: 20 54 43 50 20 73 6f 63 6b 65 74 20 61 6e 64 20   TCP socket and 
0300: 6c 6f 67 20 66 69 6c 65 73 2e 0a 0a 2e 54 50 0a  log files....TP.
0310: 2e 42 20 2d 62 20 28 6f 72 20 2d 2d 62 69 6e 64  .B -b (or --bind
0320: 29 0a 53 70 65 63 69 66 69 65 73 20 74 68 65 20  ).Specifies the 
0330: 61 64 64 72 65 73 73 20 74 6f 20 6c 69 73 74 65  address to liste
0340: 6e 20 66 6f 72 20 69 6e 63 6f 6d 69 6e 67 20 48  n for incoming H
0350: 54 54 50 0a 72 65 71 75 65 73 74 73 20 6f 6e 2e  TTP.requests on.
0360: 0a 0a 2e 54 50 0a 2e 42 20 2d 70 20 28 6f 72 20  ...TP..B -p (or 
0370: 2d 2d 70 6f 72 74 29 0a 53 70 65 63 69 66 69 65  --port).Specifie
0380: 73 20 74 68 65 20 54 43 50 20 70 6f 72 74 20 6e  s the TCP port n
0390: 75 6d 62 65 72 20 74 6f 20 6c 69 73 74 65 6e 20  umber to listen 
03a0: 66 6f 72 20 69 6e 63 6f 6d 69 6e 67 20 48 54 54  for incoming HTT
03b0: 50 0a 72 65 71 75 65 73 74 73 20 6f 6e 2e 0a 0a  P.requests on...
03c0: 2e 54 50 0a 2e 42 20 2d 74 20 28 6f 72 20 2d 2d  .TP..B -t (or --
03d0: 74 68 72 65 61 64 73 29 0a 53 70 65 63 69 66 69  threads).Specifi
03e0: 65 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  es the number of
03f0: 20 77 6f 72 6b 65 72 20 74 68 72 65 61 64 73 20   worker threads 
0400: 74 6f 20 63 72 65 61 74 65 2e 20 45 61 63 68 0a  to create. Each.
0410: 77 6f 72 6b 65 72 20 74 68 72 65 61 64 20 63 61  worker thread ca
0420: 6e 20 73 65 72 76 69 63 65 20 6f 6e 65 20 63 6f  n service one co
0430: 6e 63 75 72 72 65 6e 74 20 48 54 54 50 20 73 65  ncurrent HTTP se
0440: 73 73 69 6f 6e 2e 0a 54 68 75 73 20 74 68 65 20  ssion..Thus the 
0450: 6e 75 6d 62 65 72 20 6f 66 20 74 68 72 65 61 64  number of thread
0460: 73 20 63 72 65 61 74 65 64 20 77 69 6c 6c 20 64  s created will d
0470: 65 74 65 72 6d 69 6e 65 20 68 6f 77 0a 6d 61 6e  etermine how.man
0480: 79 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73 20 74  y simultaneous t
0490: 72 61 6e 73 66 65 72 73 20 77 69 6c 6c 20 62 65  ransfers will be
04a0: 20 70 6f 73 73 69 62 6c 65 2e 0a 0a 2e 54 50 0a   possible....TP.
04b0: 2e 42 20 2d 63 20 28 6f 72 20 2d 2d 63 61 63 68  .B -c (or --cach
04c0: 65 29 0a 53 70 65 63 69 66 69 65 73 20 74 68 65  e).Specifies the
04d0: 20 6e 75 6d 62 65 72 20 6f 66 20 66 69 6c 65 20   number of file 
04e0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 61 63 68  information cach
04f0: 65 20 65 6e 74 72 69 65 73 0a 74 6f 20 61 6c 6c  e entries.to all
0500: 6f 63 61 74 65 2e 20 20 45 61 63 68 20 63 61 63  ocate.  Each cac
0510: 68 65 20 65 6e 74 72 79 20 68 6f 6c 64 73 20 66  he entry holds f
0520: 69 6c 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  ile information 
0530: 61 73 0a 77 65 6c 6c 20 61 73 20 61 6e 20 6f 70  as.well as an op
0540: 65 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74  en file descript
0550: 6f 72 20 74 6f 20 74 68 65 20 66 69 6c 65 2c 20  or to the file, 
0560: 73 6f 20 72 65 73 6f 75 72 63 65 0a 6c 69 6d 69  so resource.limi
0570: 74 73 20 28 69 2e 65 2e 2c 20 75 6c 69 6d 69 74  ts (i.e., ulimit
0580: 29 20 73 68 6f 75 6c 64 20 62 65 20 63 6f 6e 73  ) should be cons
0590: 69 64 65 72 65 64 2e 20 20 54 68 69 73 20 73 68  idered.  This sh
05a0: 6f 75 6c 64 0a 62 65 20 61 20 70 72 69 6d 65 20  ould.be a prime 
05b0: 6e 75 6d 62 65 72 20 66 6f 72 20 69 64 65 61 6c  number for ideal
05c0: 20 75 73 65 20 77 69 74 68 20 74 68 65 20 6c 6f   use with the lo
05d0: 6f 6b 75 70 20 6d 65 74 68 6f 64 2e 0a 0a 2e 54  okup method....T
05e0: 50 0a 2e 42 20 2d 6c 20 28 6f 72 20 2d 2d 6c 6f  P..B -l (or --lo
05f0: 67 29 0a 53 70 65 63 69 66 69 65 73 20 61 20 66  g).Specifies a f
0600: 69 6c 65 6e 61 6d 65 20 74 6f 20 6f 70 65 6e 20  ilename to open 
0610: 66 6f 72 20 77 72 69 74 69 6e 67 20 6c 6f 67 20  for writing log 
0620: 65 6e 74 72 69 65 73 2e 20 20 4c 6f 67 0a 65 6e  entries.  Log.en
0630: 74 72 69 65 73 20 61 72 65 20 6d 61 64 65 20 66  tries are made f
0640: 6f 72 20 76 61 72 69 6f 75 73 20 73 74 61 67 65  or various stage
0650: 73 20 69 6e 20 74 72 61 6e 73 66 65 72 69 6e 67  s in transfering
0660: 20 66 69 6c 65 73 2e 0a 54 68 65 20 6c 6f 67 20   files..The log 
0670: 66 69 6c 65 20 69 73 20 6f 70 65 6e 65 64 20 62  file is opened b
0680: 65 66 6f 72 65 20 73 77 69 74 63 68 69 6e 67 20  efore switching 
0690: 75 73 65 72 73 20 28 73 65 65 20 22 2d 75 22 29  users (see "-u")
06a0: 0a 61 6e 64 20 72 6f 6f 74 20 64 69 72 65 63 74  .and root direct
06b0: 6f 72 69 65 73 20 28 73 65 65 20 22 2d 72 22 29  ories (see "-r")
06c0: 2e 20 20 54 68 65 20 6c 6f 67 20 66 69 6c 65 20  .  The log file 
06d0: 69 73 20 6e 65 76 65 72 0a 63 6c 6f 73 65 64 20  is never.closed 
06e0: 73 6f 20 6c 6f 67 20 72 6f 74 61 74 69 6f 6e 20  so log rotation 
06f0: 77 69 74 68 6f 75 74 20 73 74 6f 70 70 69 6e 67  without stopping
0700: 20 74 68 65 20 64 61 65 6d 6f 6e 20 69 73 20 77   the daemon is w
0710: 69 6c 6c 0a 6e 6f 74 20 77 6f 72 6b 2e 20 20 54  ill.not work.  T
0720: 68 65 20 76 61 6c 75 65 20 6f 66 20 22 2d 22 20  he value of "-" 
0730: 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 73  indicates that s
0740: 74 61 6e 64 61 72 64 20 6f 75 74 70 75 74 0a 73  tandard output.s
0750: 68 6f 75 6c 64 20 62 65 20 75 73 65 64 20 66 6f  hould be used fo
0760: 72 20 6c 6f 67 67 69 6e 67 2e 0a 0a 2e 54 50 0a  r logging....TP.
0770: 2e 42 20 2d 75 20 28 6f 72 20 2d 2d 75 73 65 72  .B -u (or --user
0780: 29 0a 53 70 65 63 69 66 69 65 73 20 74 68 65 20  ).Specifies the 
0790: 75 73 65 72 20 74 6f 20 73 77 69 74 63 68 20 75  user to switch u
07a0: 73 65 72 20 49 44 73 20 74 6f 20 62 65 66 6f 72  ser IDs to befor
07b0: 65 20 73 65 72 76 69 63 69 6e 67 0a 72 65 71 75  e servicing.requ
07c0: 65 73 74 73 2e 20 20 54 68 65 20 64 65 66 61 75  ests.  The defau
07d0: 6c 74 20 69 73 20 6e 6f 74 20 63 68 61 6e 67 65  lt is not change
07e0: 20 75 73 65 72 20 49 44 73 2e 0a 0a 2e 54 50 0a   user IDs....TP.
07f0: 2e 42 20 2d 72 20 28 6f 72 20 2d 2d 72 6f 6f 74  .B -r (or --root
0800: 29 0a 53 70 65 63 69 66 69 65 73 20 74 68 65 20  ).Specifies the 
0810: 64 69 72 65 63 74 6f 72 79 20 74 6f 20 61 63 74  directory to act
0820: 20 61 73 20 74 68 65 20 72 6f 6f 74 20 64 69 72   as the root dir
0830: 65 63 74 6f 72 79 20 66 6f 72 0a 74 68 65 20 66  ectory for.the f
0840: 69 6c 65 20 73 65 72 76 65 72 2e 20 20 49 66 20  ile server.  If 
0850: 74 68 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 73  this option is s
0860: 70 65 63 69 66 69 65 64 2c 20 63 68 72 6f 6f 74  pecified, chroot
0870: 28 32 29 0a 69 73 20 63 61 6c 6c 65 64 2e 20 20  (2).is called.  
0880: 54 68 65 20 64 65 66 61 75 6c 74 20 69 73 20 6e  The default is n
0890: 6f 74 20 63 68 61 6e 67 65 20 72 6f 6f 74 20 64  ot change root d
08a0: 69 72 65 63 74 6f 72 69 65 73 2c 0a 74 68 61 74  irectories,.that
08b0: 20 69 73 2c 20 74 68 65 20 22 2f 22 20 64 69 72   is, the "/" dir
08c0: 65 63 74 6f 72 79 20 69 73 20 73 68 61 72 65 64  ectory is shared
08d0: 20 6f 75 74 2e 20 20 54 68 69 73 20 77 69 6c 6c   out.  This will
08e0: 0a 6c 69 6b 65 6c 79 20 62 65 20 61 20 73 65 63  .likely be a sec
08f0: 75 72 69 74 79 20 69 73 73 75 65 2c 20 73 6f 20  urity issue, so 
0900: 74 68 69 73 20 6f 70 74 69 6f 6e 20 73 68 6f 75  this option shou
0910: 6c 64 20 61 6c 77 61 79 73 0a 62 65 20 75 73 65  ld always.be use
0920: 64 2e 0a 0a 2e 53 48 20 41 55 54 48 4f 52 0a 2e  d....SH AUTHOR..
0930: 53 70 0a 52 6f 79 20 4b 65 65 6e 65 0a 2e 49 20  Sp.Roy Keene..I 
0940: 3c 66 69 6c 65 64 40 72 6b 65 65 6e 65 2e 6f 72  <filed@rkeene.or
0950: 67 3e 0a                                         g>.