Hex Artifact Content

Artifact 5afcb460b6910e78d9510be93eff94b152b4835d:


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 37 22 0a 2e 53 48 20 4e 41 4d 45  ed 1.7"..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 56 20 7c 20 5c 2d 5c 2d 76  B [{ \-V | \-\-v
00d0: 68 6f 73 74 20 7d 5d 0a 2e 52 42 20 5b 7b 20 5c  host }]..RB [{ \
00e0: 2d 62 20 7c 20 5c 2d 5c 2d 62 69 6e 64 20 7d 0a  -b | \-\-bind }.
00f0: 2e 49 52 20 61 64 64 72 65 73 73 20 5d 0a 2e 52  .IR address ]..R
0100: 42 20 5b 7b 20 5c 2d 70 20 7c 20 5c 2d 5c 2d 70  B [{ \-p | \-\-p
0110: 6f 72 74 20 7d 0a 2e 49 52 20 70 6f 72 74 20 5d  ort }..IR port ]
0120: 0a 2e 52 42 20 5b 7b 20 5c 2d 74 20 7c 20 5c 2d  ..RB [{ \-t | \-
0130: 5c 2d 74 68 72 65 61 64 73 20 7d 0a 2e 49 52 20  \-threads }..IR 
0140: 63 6f 75 6e 74 20 5d 0a 2e 52 42 20 5b 7b 20 5c  count ]..RB [{ \
0150: 2d 63 20 7c 20 5c 2d 5c 2d 63 61 63 68 65 20 7d  -c | \-\-cache }
0160: 0a 2e 49 52 20 65 6e 74 72 69 65 73 20 5d 0a 2e  ..IR entries ]..
0170: 52 42 20 5b 7b 20 5c 2d 6c 20 7c 20 5c 2d 5c 2d  RB [{ \-l | \-\-
0180: 6c 6f 67 20 7d 0a 2e 49 52 20 66 69 6c 65 20 5d  log }..IR file ]
0190: 0a 2e 52 42 20 5b 7b 20 5c 2d 75 20 7c 20 5c 2d  ..RB [{ \-u | \-
01a0: 5c 2d 75 73 65 72 20 7d 0a 2e 49 52 20 75 73 65  \-user }..IR use
01b0: 72 20 5d 0a 2e 52 42 20 5b 7b 20 5c 2d 72 20 7c  r ]..RB [{ \-r |
01c0: 20 5c 2d 5c 2d 72 6f 6f 74 20 7d 0a 2e 49 52 20   \-\-root }..IR 
01d0: 64 69 72 65 63 74 6f 72 79 20 5d 0a 0a 2e 6c 6c  directory ]...ll
01e0: 20 2d 31 30 0a 2e 53 48 20 44 45 53 43 52 49 50   -10..SH DESCRIP
01f0: 54 49 4f 4e 0a 2e 49 20 46 49 4c 45 44 0a 73 65  TION..I FILED.se
0200: 72 76 65 73 20 66 69 6c 65 73 20 6f 76 65 72 20  rves files over 
0210: 48 54 54 50 20 61 73 20 6d 69 6e 69 6d 61 6c 6c  HTTP as minimall
0220: 79 20 61 73 20 70 6f 73 73 69 62 6c 65 2e 20 20  y as possible.  
0230: 4f 6e 6c 79 20 73 74 61 74 69 63 20 66 69 6c 65  Only static file
0240: 73 20 28 69 2e 65 2e 2c 20 66 69 6c 65 73 20 74  s (i.e., files t
0250: 68 61 74 20 6e 65 76 65 72 20 63 68 61 6e 67 65  hat never change
0260: 20 6f 72 20 61 72 65 20 72 65 70 6c 61 63 65 64   or are replaced
0270: 29 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 2e  ) are supported.
0280: 0a 0a 2e 53 48 20 4f 50 54 49 4f 4e 53 0a 2e 54  ...SH OPTIONS..T
0290: 50 0a 2e 42 20 2d 68 20 28 6f 72 20 2d 2d 68 65  P..B -h (or --he
02a0: 6c 70 29 0a 50 72 69 6e 74 73 20 64 65 74 61 69  lp).Prints detai
02b0: 6c 65 64 20 75 73 61 67 65 20 69 6e 66 6f 72 6d  led usage inform
02c0: 61 74 69 6f 6e 2e 0a 0a 2e 54 50 0a 2e 42 20 2d  ation....TP..B -
02d0: 64 20 28 6f 72 20 2d 2d 64 61 65 6d 6f 6e 29 0a  d (or --daemon).
02e0: 49 6e 73 74 72 75 63 74 73 0a 2e 42 20 66 69 6c  Instructs..B fil
02f0: 65 64 0a 74 6f 20 62 65 63 6f 6d 65 20 61 20 64  ed.to become a d
0300: 61 65 6d 6f 6e 20 61 66 74 65 72 20 69 6e 69 74  aemon after init
0310: 69 61 6c 69 7a 69 6e 67 0a 74 68 65 20 6c 69 73  ializing.the lis
0320: 74 65 6e 69 6e 67 20 54 43 50 20 73 6f 63 6b 65  tening TCP socke
0330: 74 20 61 6e 64 20 6c 6f 67 20 66 69 6c 65 73 2e  t and log files.
0340: 0a 0a 2e 54 50 0a 2e 42 20 2d 76 20 28 6f 72 20  ...TP..B -v (or 
0350: 2d 2d 76 65 72 73 69 6f 6e 29 0a 49 6e 73 74 72  --version).Instr
0360: 75 63 74 73 0a 2e 42 20 66 69 6c 65 64 0a 74 6f  ucts..B filed.to
0370: 20 70 72 69 6e 74 20 6f 75 74 20 69 74 73 20 76   print out its v
0380: 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 20 61 6e  ersion number an
0390: 64 20 74 68 65 6e 20 65 78 69 74 2e 0a 0a 2e 54  d then exit....T
03a0: 50 0a 2e 42 20 2d 56 20 28 6f 72 20 2d 2d 76 68  P..B -V (or --vh
03b0: 6f 73 74 29 0a 69 6e 73 74 72 75 63 74 73 20 66  ost).instructs f
03c0: 69 6c 65 64 20 74 6f 20 70 72 65 70 65 6e 64 20  iled to prepend 
03d0: 61 6c 6c 20 72 65 71 75 65 73 74 73 20 77 69 74  all requests wit
03e0: 68 20 74 68 65 69 72 20 48 54 54 50 0a 48 6f 73  h their HTTP.Hos
03f0: 74 20 68 65 61 64 65 72 2e 0a 0a 2e 54 50 0a 2e  t header....TP..
0400: 42 20 2d 62 20 28 6f 72 20 2d 2d 62 69 6e 64 29  B -b (or --bind)
0410: 0a 53 70 65 63 69 66 69 65 73 20 74 68 65 20 61  .Specifies the a
0420: 64 64 72 65 73 73 20 74 6f 20 6c 69 73 74 65 6e  ddress to listen
0430: 20 66 6f 72 20 69 6e 63 6f 6d 69 6e 67 20 48 54   for incoming HT
0440: 54 50 0a 72 65 71 75 65 73 74 73 20 6f 6e 2e 0a  TP.requests on..
0450: 0a 2e 54 50 0a 2e 42 20 2d 70 20 28 6f 72 20 2d  ..TP..B -p (or -
0460: 2d 70 6f 72 74 29 0a 53 70 65 63 69 66 69 65 73  -port).Specifies
0470: 20 74 68 65 20 54 43 50 20 70 6f 72 74 20 6e 75   the TCP port nu
0480: 6d 62 65 72 20 74 6f 20 6c 69 73 74 65 6e 20 66  mber to listen f
0490: 6f 72 20 69 6e 63 6f 6d 69 6e 67 20 48 54 54 50  or incoming HTTP
04a0: 0a 72 65 71 75 65 73 74 73 20 6f 6e 2e 0a 0a 2e  .requests on....
04b0: 54 50 0a 2e 42 20 2d 74 20 28 6f 72 20 2d 2d 74  TP..B -t (or --t
04c0: 68 72 65 61 64 73 29 0a 53 70 65 63 69 66 69 65  hreads).Specifie
04d0: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s the number of 
04e0: 77 6f 72 6b 65 72 20 74 68 72 65 61 64 73 20 74  worker threads t
04f0: 6f 20 63 72 65 61 74 65 2e 20 45 61 63 68 0a 77  o create. Each.w
0500: 6f 72 6b 65 72 20 74 68 72 65 61 64 20 63 61 6e  orker thread can
0510: 20 73 65 72 76 69 63 65 20 6f 6e 65 20 63 6f 6e   service one con
0520: 63 75 72 72 65 6e 74 20 48 54 54 50 20 73 65 73  current HTTP ses
0530: 73 69 6f 6e 2e 0a 54 68 75 73 20 74 68 65 20 6e  sion..Thus the n
0540: 75 6d 62 65 72 20 6f 66 20 74 68 72 65 61 64 73  umber of threads
0550: 20 63 72 65 61 74 65 64 20 77 69 6c 6c 20 64 65   created will de
0560: 74 65 72 6d 69 6e 65 20 68 6f 77 0a 6d 61 6e 79  termine how.many
0570: 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73 20 74 72   simultaneous tr
0580: 61 6e 73 66 65 72 73 20 77 69 6c 6c 20 62 65 20  ansfers will be 
0590: 70 6f 73 73 69 62 6c 65 2e 0a 0a 2e 54 50 0a 2e  possible....TP..
05a0: 42 20 2d 63 20 28 6f 72 20 2d 2d 63 61 63 68 65  B -c (or --cache
05b0: 29 0a 53 70 65 63 69 66 69 65 73 20 74 68 65 20  ).Specifies the 
05c0: 6e 75 6d 62 65 72 20 6f 66 20 66 69 6c 65 20 69  number of file i
05d0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 61 63 68 65  nformation cache
05e0: 20 65 6e 74 72 69 65 73 0a 74 6f 20 61 6c 6c 6f   entries.to allo
05f0: 63 61 74 65 2e 20 20 45 61 63 68 20 63 61 63 68  cate.  Each cach
0600: 65 20 65 6e 74 72 79 20 68 6f 6c 64 73 20 66 69  e entry holds fi
0610: 6c 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61  le information a
0620: 73 0a 77 65 6c 6c 20 61 73 20 61 6e 20 6f 70 65  s.well as an ope
0630: 6e 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f  n file descripto
0640: 72 20 74 6f 20 74 68 65 20 66 69 6c 65 2c 20 73  r to the file, s
0650: 6f 20 72 65 73 6f 75 72 63 65 0a 6c 69 6d 69 74  o resource.limit
0660: 73 20 28 69 2e 65 2e 2c 20 75 6c 69 6d 69 74 29  s (i.e., ulimit)
0670: 20 73 68 6f 75 6c 64 20 62 65 20 63 6f 6e 73 69   should be consi
0680: 64 65 72 65 64 2e 20 20 54 68 69 73 20 73 68 6f  dered.  This sho
0690: 75 6c 64 0a 62 65 20 61 20 70 72 69 6d 65 20 6e  uld.be a prime n
06a0: 75 6d 62 65 72 20 66 6f 72 20 69 64 65 61 6c 20  umber for ideal 
06b0: 75 73 65 20 77 69 74 68 20 74 68 65 20 6c 6f 6f  use with the loo
06c0: 6b 75 70 20 6d 65 74 68 6f 64 2e 0a 0a 2e 54 50  kup method....TP
06d0: 0a 2e 42 20 2d 6c 20 28 6f 72 20 2d 2d 6c 6f 67  ..B -l (or --log
06e0: 29 0a 53 70 65 63 69 66 69 65 73 20 61 20 66 69  ).Specifies a fi
06f0: 6c 65 6e 61 6d 65 20 74 6f 20 6f 70 65 6e 20 66  lename to open f
0700: 6f 72 20 77 72 69 74 69 6e 67 20 6c 6f 67 20 65  or writing log e
0710: 6e 74 72 69 65 73 2e 20 20 4c 6f 67 0a 65 6e 74  ntries.  Log.ent
0720: 72 69 65 73 20 61 72 65 20 6d 61 64 65 20 66 6f  ries are made fo
0730: 72 20 76 61 72 69 6f 75 73 20 73 74 61 67 65 73  r various stages
0740: 20 69 6e 20 74 72 61 6e 73 66 65 72 69 6e 67 20   in transfering 
0750: 66 69 6c 65 73 2e 0a 54 68 65 20 6c 6f 67 20 66  files..The log f
0760: 69 6c 65 20 69 73 20 6f 70 65 6e 65 64 20 62 65  ile is opened be
0770: 66 6f 72 65 20 73 77 69 74 63 68 69 6e 67 20 75  fore switching u
0780: 73 65 72 73 20 28 73 65 65 20 22 2d 75 22 29 0a  sers (see "-u").
0790: 61 6e 64 20 72 6f 6f 74 20 64 69 72 65 63 74 6f  and root directo
07a0: 72 69 65 73 20 28 73 65 65 20 22 2d 72 22 29 2e  ries (see "-r").
07b0: 20 20 54 68 65 20 6c 6f 67 20 66 69 6c 65 20 69    The log file i
07c0: 73 20 6e 65 76 65 72 0a 63 6c 6f 73 65 64 20 73  s never.closed s
07d0: 6f 20 6c 6f 67 20 72 6f 74 61 74 69 6f 6e 20 77  o log rotation w
07e0: 69 74 68 6f 75 74 20 73 74 6f 70 70 69 6e 67 20  ithout stopping 
07f0: 74 68 65 20 64 61 65 6d 6f 6e 20 69 73 20 77 69  the daemon is wi
0800: 6c 6c 0a 6e 6f 74 20 77 6f 72 6b 2e 20 20 54 68  ll.not work.  Th
0810: 65 20 76 61 6c 75 65 20 6f 66 20 22 2d 22 20 69  e value of "-" i
0820: 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 73 74  ndicates that st
0830: 61 6e 64 61 72 64 20 6f 75 74 70 75 74 0a 73 68  andard output.sh
0840: 6f 75 6c 64 20 62 65 20 75 73 65 64 20 66 6f 72  ould be used for
0850: 20 6c 6f 67 67 69 6e 67 2e 20 20 49 66 20 74 68   logging.  If th
0860: 65 20 66 69 6c 65 6e 61 6d 65 20 62 65 67 69 6e  e filename begin
0870: 73 20 77 69 74 68 20 61 0a 70 69 70 65 20 28 22  s with a.pipe ("
0880: 7c 22 29 20 74 68 65 6e 20 61 20 70 72 6f 63 65  |") then a proce
0890: 73 73 20 69 73 20 73 74 61 72 74 65 64 20 61 6e  ss is started an
08a0: 64 20 75 73 65 64 20 66 6f 72 20 6c 6f 67 67 69  d used for loggi
08b0: 6e 67 0a 69 6e 73 74 65 61 64 20 6f 66 20 61 20  ng.instead of a 
08c0: 66 69 6c 65 2e 0a 0a 2e 54 50 0a 2e 42 20 2d 75  file....TP..B -u
08d0: 20 28 6f 72 20 2d 2d 75 73 65 72 29 0a 53 70 65   (or --user).Spe
08e0: 63 69 66 69 65 73 20 74 68 65 20 75 73 65 72 20  cifies the user 
08f0: 74 6f 20 73 77 69 74 63 68 20 75 73 65 72 20 49  to switch user I
0900: 44 73 20 74 6f 20 62 65 66 6f 72 65 20 73 65 72  Ds to before ser
0910: 76 69 63 69 6e 67 0a 72 65 71 75 65 73 74 73 2e  vicing.requests.
0920: 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 73    The default is
0930: 20 6e 6f 74 20 63 68 61 6e 67 65 20 75 73 65 72   not change user
0940: 20 49 44 73 2e 0a 0a 2e 54 50 0a 2e 42 20 2d 72   IDs....TP..B -r
0950: 20 28 6f 72 20 2d 2d 72 6f 6f 74 29 0a 53 70 65   (or --root).Spe
0960: 63 69 66 69 65 73 20 74 68 65 20 64 69 72 65 63  cifies the direc
0970: 74 6f 72 79 20 74 6f 20 61 63 74 20 61 73 20 74  tory to act as t
0980: 68 65 20 72 6f 6f 74 20 64 69 72 65 63 74 6f 72  he root director
0990: 79 20 66 6f 72 0a 74 68 65 20 66 69 6c 65 20 73  y for.the file s
09a0: 65 72 76 65 72 2e 20 20 49 66 20 74 68 69 73 20  erver.  If this 
09b0: 6f 70 74 69 6f 6e 20 69 73 20 73 70 65 63 69 66  option is specif
09c0: 69 65 64 2c 20 63 68 72 6f 6f 74 28 32 29 0a 69  ied, chroot(2).i
09d0: 73 20 63 61 6c 6c 65 64 2e 20 20 54 68 65 20 64  s called.  The d
09e0: 65 66 61 75 6c 74 20 69 73 20 6e 6f 74 20 63 68  efault is not ch
09f0: 61 6e 67 65 20 72 6f 6f 74 20 64 69 72 65 63 74  ange root direct
0a00: 6f 72 69 65 73 2c 0a 74 68 61 74 20 69 73 2c 20  ories,.that is, 
0a10: 74 68 65 20 22 2f 22 20 64 69 72 65 63 74 6f 72  the "/" director
0a20: 79 20 69 73 20 73 68 61 72 65 64 20 6f 75 74 2e  y is shared out.
0a30: 20 20 54 68 69 73 20 77 69 6c 6c 0a 6c 69 6b 65    This will.like
0a40: 6c 79 20 62 65 20 61 20 73 65 63 75 72 69 74 79  ly be a security
0a50: 20 69 73 73 75 65 2c 20 73 6f 20 74 68 69 73 20   issue, so this 
0a60: 6f 70 74 69 6f 6e 20 73 68 6f 75 6c 64 20 61 6c  option should al
0a70: 77 61 79 73 0a 62 65 20 75 73 65 64 2e 0a 0a 2e  ways.be used....
0a80: 53 48 20 41 55 54 48 4f 52 0a 2e 53 70 0a 52 6f  SH AUTHOR..Sp.Ro
0a90: 79 20 4b 65 65 6e 65 0a 2e 49 20 3c 66 69 6c 65  y Keene..I <file
0aa0: 64 40 72 6b 65 65 6e 65 2e 6f 72 67 3e 0a        d@rkeene.org>.