Hex Artifact Content

Artifact 3154c0e2435f35a68e3f1af042a2ca1ecdf7f118:


0000: 2e 50 55 0a 2e 54 48 20 46 49 4c 45 44 20 31 20  .PU..TH FILED 1 
0010: 22 32 32 20 53 65 70 20 32 30 31 36 22 20 22 66  "22 Sep 2016" "f
0020: 69 6c 65 64 20 31 2e 32 32 22 0a 2e 53 48 20 4e  iled 1.22"..SH N
0030: 41 4d 45 0a 66 69 6c 65 64 20 5c 2d 20 73 65 72  AME.filed \- ser
0040: 76 65 20 66 69 6c 65 73 20 6f 76 65 72 20 48 54  ve files over HT
0050: 54 50 0a 2e 53 48 20 53 59 4e 4f 50 53 49 53 0a  TP..SH SYNOPSIS.
0060: 2e 6c 6c 20 2b 31 30 0a 2e 42 20 66 69 6c 65 64  .ll +10..B filed
0070: 0a 2e 52 42 20 5b 7b 20 5c 2d 68 20 7c 20 5c 2d  ..RB [{ \-h | \-
0080: 5c 2d 68 65 6c 70 20 7d 5d 0a 2e 52 42 20 5b 7b  \-help }]..RB [{
0090: 20 5c 2d 64 20 7c 20 5c 2d 5c 2d 64 61 65 6d 6f   \-d | \-\-daemo
00a0: 6e 20 7d 5d 0a 2e 52 42 20 5b 7b 20 5c 2d 76 20  n }]..RB [{ \-v 
00b0: 7c 20 5c 2d 5c 2d 76 65 72 73 69 6f 6e 20 7d 5d  | \-\-version }]
00c0: 0a 2e 52 42 20 5b 7b 20 5c 2d 56 20 7c 20 5c 2d  ..RB [{ \-V | \-
00d0: 5c 2d 76 68 6f 73 74 20 7d 5d 0a 2e 52 42 20 5b  \-vhost }]..RB [
00e0: 7b 20 5c 2d 62 20 7c 20 5c 2d 5c 2d 62 69 6e 64  { \-b | \-\-bind
00f0: 20 7d 0a 2e 49 52 20 61 64 64 72 65 73 73 20 5d   }..IR address ]
0100: 0a 2e 52 42 20 5b 7b 20 5c 2d 70 20 7c 20 5c 2d  ..RB [{ \-p | \-
0110: 5c 2d 70 6f 72 74 20 7d 0a 2e 49 52 20 70 6f 72  \-port }..IR por
0120: 74 20 5d 0a 2e 52 42 20 5b 7b 20 5c 2d 74 20 7c  t ]..RB [{ \-t |
0130: 20 5c 2d 5c 2d 74 68 72 65 61 64 73 20 7d 0a 2e   \-\-threads }..
0140: 49 52 20 63 6f 75 6e 74 20 5d 0a 2e 52 42 20 5b  IR count ]..RB [
0150: 7b 20 5c 2d 63 20 7c 20 5c 2d 5c 2d 63 61 63 68  { \-c | \-\-cach
0160: 65 20 7d 0a 2e 49 52 20 65 6e 74 72 69 65 73 20  e }..IR entries 
0170: 5d 0a 2e 52 42 20 5b 7b 20 5c 2d 6c 20 7c 20 5c  ]..RB [{ \-l | \
0180: 2d 5c 2d 6c 6f 67 20 7d 0a 2e 49 52 20 66 69 6c  -\-log }..IR fil
0190: 65 20 5d 0a 2e 52 42 20 5b 7b 20 5c 2d 75 20 7c  e ]..RB [{ \-u |
01a0: 20 5c 2d 5c 2d 75 73 65 72 20 7d 0a 2e 49 52 20   \-\-user }..IR 
01b0: 75 73 65 72 20 5d 0a 2e 52 42 20 5b 7b 20 5c 2d  user ]..RB [{ \-
01c0: 72 20 7c 20 5c 2d 5c 2d 72 6f 6f 74 20 7d 0a 2e  r | \-\-root }..
01d0: 49 52 20 64 69 72 65 63 74 6f 72 79 20 5d 0a 0a  IR directory ]..
01e0: 2e 6c 6c 20 2d 31 30 0a 2e 53 48 20 44 45 53 43  .ll -10..SH DESC
01f0: 52 49 50 54 49 4f 4e 0a 2e 49 20 46 49 4c 45 44  RIPTION..I FILED
0200: 0a 73 65 72 76 65 73 20 66 69 6c 65 73 20 6f 76  .serves files ov
0210: 65 72 20 48 54 54 50 20 61 73 20 6d 69 6e 69 6d  er HTTP as minim
0220: 61 6c 6c 79 20 61 73 20 70 6f 73 73 69 62 6c 65  ally as possible
0230: 2e 20 20 4f 6e 6c 79 20 73 74 61 74 69 63 20 66  .  Only static f
0240: 69 6c 65 73 20 28 69 2e 65 2e 2c 20 66 69 6c 65  iles (i.e., file
0250: 73 20 74 68 61 74 20 6e 65 76 65 72 20 63 68 61  s that never cha
0260: 6e 67 65 20 6f 72 20 61 72 65 20 72 65 70 6c 61  nge or are repla
0270: 63 65 64 29 20 61 72 65 20 73 75 70 70 6f 72 74  ced) are support
0280: 65 64 2e 0a 0a 2e 53 48 20 4f 50 54 49 4f 4e 53  ed....SH OPTIONS
0290: 0a 2e 54 50 0a 2e 42 20 2d 68 20 28 6f 72 20 2d  ..TP..B -h (or -
02a0: 2d 68 65 6c 70 29 0a 50 72 69 6e 74 73 20 64 65  -help).Prints de
02b0: 74 61 69 6c 65 64 20 75 73 61 67 65 20 69 6e 66  tailed usage inf
02c0: 6f 72 6d 61 74 69 6f 6e 2e 0a 0a 2e 54 50 0a 2e  ormation....TP..
02d0: 42 20 2d 64 20 28 6f 72 20 2d 2d 64 61 65 6d 6f  B -d (or --daemo
02e0: 6e 29 0a 49 6e 73 74 72 75 63 74 73 0a 2e 42 20  n).Instructs..B 
02f0: 66 69 6c 65 64 0a 74 6f 20 62 65 63 6f 6d 65 20  filed.to become 
0300: 61 20 64 61 65 6d 6f 6e 20 61 66 74 65 72 20 69  a daemon after i
0310: 6e 69 74 69 61 6c 69 7a 69 6e 67 0a 74 68 65 20  nitializing.the 
0320: 6c 69 73 74 65 6e 69 6e 67 20 54 43 50 20 73 6f  listening TCP so
0330: 63 6b 65 74 20 61 6e 64 20 6c 6f 67 20 66 69 6c  cket and log fil
0340: 65 73 2e 0a 0a 2e 54 50 0a 2e 42 20 2d 76 20 28  es....TP..B -v (
0350: 6f 72 20 2d 2d 76 65 72 73 69 6f 6e 29 0a 49 6e  or --version).In
0360: 73 74 72 75 63 74 73 0a 2e 42 20 66 69 6c 65 64  structs..B filed
0370: 0a 74 6f 20 70 72 69 6e 74 20 6f 75 74 20 69 74  .to print out it
0380: 73 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72  s version number
0390: 20 61 6e 64 20 74 68 65 6e 20 65 78 69 74 2e 0a   and then exit..
03a0: 0a 2e 54 50 0a 2e 42 20 2d 56 20 28 6f 72 20 2d  ..TP..B -V (or -
03b0: 2d 76 68 6f 73 74 29 0a 69 6e 73 74 72 75 63 74  -vhost).instruct
03c0: 73 20 66 69 6c 65 64 20 74 6f 20 70 72 65 70 65  s filed to prepe
03d0: 6e 64 20 61 6c 6c 20 72 65 71 75 65 73 74 73 20  nd all requests 
03e0: 77 69 74 68 20 74 68 65 69 72 20 48 54 54 50 0a  with their HTTP.
03f0: 48 6f 73 74 20 68 65 61 64 65 72 2e 0a 0a 2e 54  Host header....T
0400: 50 0a 2e 42 20 2d 62 20 28 6f 72 20 2d 2d 62 69  P..B -b (or --bi
0410: 6e 64 29 0a 53 70 65 63 69 66 69 65 73 20 74 68  nd).Specifies th
0420: 65 20 61 64 64 72 65 73 73 20 74 6f 20 6c 69 73  e address to lis
0430: 74 65 6e 20 66 6f 72 20 69 6e 63 6f 6d 69 6e 67  ten for incoming
0440: 20 48 54 54 50 0a 72 65 71 75 65 73 74 73 20 6f   HTTP.requests o
0450: 6e 2e 0a 0a 2e 54 50 0a 2e 42 20 2d 70 20 28 6f  n....TP..B -p (o
0460: 72 20 2d 2d 70 6f 72 74 29 0a 53 70 65 63 69 66  r --port).Specif
0470: 69 65 73 20 74 68 65 20 54 43 50 20 70 6f 72 74  ies the TCP port
0480: 20 6e 75 6d 62 65 72 20 74 6f 20 6c 69 73 74 65   number to liste
0490: 6e 20 66 6f 72 20 69 6e 63 6f 6d 69 6e 67 20 48  n for incoming H
04a0: 54 54 50 0a 72 65 71 75 65 73 74 73 20 6f 6e 2e  TTP.requests on.
04b0: 0a 0a 2e 54 50 0a 2e 42 20 2d 74 20 28 6f 72 20  ...TP..B -t (or 
04c0: 2d 2d 74 68 72 65 61 64 73 29 0a 53 70 65 63 69  --threads).Speci
04d0: 66 69 65 73 20 74 68 65 20 6e 75 6d 62 65 72 20  fies the number 
04e0: 6f 66 20 77 6f 72 6b 65 72 20 74 68 72 65 61 64  of worker thread
04f0: 73 20 74 6f 20 63 72 65 61 74 65 2e 20 45 61 63  s to create. Eac
0500: 68 0a 77 6f 72 6b 65 72 20 74 68 72 65 61 64 20  h.worker thread 
0510: 63 61 6e 20 73 65 72 76 69 63 65 20 6f 6e 65 20  can service one 
0520: 63 6f 6e 63 75 72 72 65 6e 74 20 48 54 54 50 20  concurrent HTTP 
0530: 73 65 73 73 69 6f 6e 2e 0a 54 68 75 73 20 74 68  session..Thus th
0540: 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 72 65  e number of thre
0550: 61 64 73 20 63 72 65 61 74 65 64 20 77 69 6c 6c  ads created will
0560: 20 64 65 74 65 72 6d 69 6e 65 20 68 6f 77 0a 6d   determine how.m
0570: 61 6e 79 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73  any simultaneous
0580: 20 74 72 61 6e 73 66 65 72 73 20 77 69 6c 6c 20   transfers will 
0590: 62 65 20 70 6f 73 73 69 62 6c 65 2e 0a 0a 2e 54  be possible....T
05a0: 50 0a 2e 42 20 2d 63 20 28 6f 72 20 2d 2d 63 61  P..B -c (or --ca
05b0: 63 68 65 29 0a 53 70 65 63 69 66 69 65 73 20 74  che).Specifies t
05c0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 69 6c  he number of fil
05d0: 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 61  e information ca
05e0: 63 68 65 20 65 6e 74 72 69 65 73 0a 74 6f 20 61  che entries.to a
05f0: 6c 6c 6f 63 61 74 65 2e 20 20 45 61 63 68 20 63  llocate.  Each c
0600: 61 63 68 65 20 65 6e 74 72 79 20 68 6f 6c 64 73  ache entry holds
0610: 20 66 69 6c 65 20 69 6e 66 6f 72 6d 61 74 69 6f   file informatio
0620: 6e 20 61 73 0a 77 65 6c 6c 20 61 73 20 61 6e 20  n as.well as an 
0630: 6f 70 65 6e 20 66 69 6c 65 20 64 65 73 63 72 69  open file descri
0640: 70 74 6f 72 20 74 6f 20 74 68 65 20 66 69 6c 65  ptor to the file
0650: 2c 20 73 6f 20 72 65 73 6f 75 72 63 65 0a 6c 69  , so resource.li
0660: 6d 69 74 73 20 28 69 2e 65 2e 2c 20 75 6c 69 6d  mits (i.e., ulim
0670: 69 74 29 20 73 68 6f 75 6c 64 20 62 65 20 63 6f  it) should be co
0680: 6e 73 69 64 65 72 65 64 2e 20 20 54 68 69 73 20  nsidered.  This 
0690: 73 68 6f 75 6c 64 0a 62 65 20 61 20 70 72 69 6d  should.be a prim
06a0: 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 69 64 65  e number for ide
06b0: 61 6c 20 75 73 65 20 77 69 74 68 20 74 68 65 20  al use with the 
06c0: 6c 6f 6f 6b 75 70 20 6d 65 74 68 6f 64 2e 0a 0a  lookup method...
06d0: 2e 54 50 0a 2e 42 20 2d 6c 20 28 6f 72 20 2d 2d  .TP..B -l (or --
06e0: 6c 6f 67 29 0a 53 70 65 63 69 66 69 65 73 20 61  log).Specifies a
06f0: 20 66 69 6c 65 6e 61 6d 65 20 74 6f 20 6f 70 65   filename to ope
0700: 6e 20 66 6f 72 20 77 72 69 74 69 6e 67 20 6c 6f  n for writing lo
0710: 67 20 65 6e 74 72 69 65 73 2e 20 20 4c 6f 67 0a  g entries.  Log.
0720: 65 6e 74 72 69 65 73 20 61 72 65 20 6d 61 64 65  entries are made
0730: 20 66 6f 72 20 76 61 72 69 6f 75 73 20 73 74 61   for various sta
0740: 67 65 73 20 69 6e 20 74 72 61 6e 73 66 65 72 69  ges in transferi
0750: 6e 67 20 66 69 6c 65 73 2e 0a 54 68 65 20 6c 6f  ng files..The lo
0760: 67 20 66 69 6c 65 20 69 73 20 6f 70 65 6e 65 64  g file is opened
0770: 20 62 65 66 6f 72 65 20 73 77 69 74 63 68 69 6e   before switchin
0780: 67 20 75 73 65 72 73 20 28 73 65 65 20 22 2d 75  g users (see "-u
0790: 22 29 0a 61 6e 64 20 72 6f 6f 74 20 64 69 72 65  ").and root dire
07a0: 63 74 6f 72 69 65 73 20 28 73 65 65 20 22 2d 72  ctories (see "-r
07b0: 22 29 2e 20 20 54 68 65 20 6c 6f 67 20 66 69 6c  ").  The log fil
07c0: 65 20 69 73 20 6e 65 76 65 72 0a 63 6c 6f 73 65  e is never.close
07d0: 64 20 73 6f 20 6c 6f 67 20 72 6f 74 61 74 69 6f  d so log rotatio
07e0: 6e 20 77 69 74 68 6f 75 74 20 73 74 6f 70 70 69  n without stoppi
07f0: 6e 67 20 74 68 65 20 64 61 65 6d 6f 6e 20 69 73  ng the daemon is
0800: 20 77 69 6c 6c 0a 6e 6f 74 20 77 6f 72 6b 2e 20   will.not work. 
0810: 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 22 2d   The value of "-
0820: 22 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74  " indicates that
0830: 20 73 74 61 6e 64 61 72 64 20 6f 75 74 70 75 74   standard output
0840: 0a 73 68 6f 75 6c 64 20 62 65 20 75 73 65 64 20  .should be used 
0850: 66 6f 72 20 6c 6f 67 67 69 6e 67 2e 20 20 49 66  for logging.  If
0860: 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 62 65   the filename be
0870: 67 69 6e 73 20 77 69 74 68 20 61 0a 70 69 70 65  gins with a.pipe
0880: 20 28 22 7c 22 29 20 74 68 65 6e 20 61 20 70 72   ("|") then a pr
0890: 6f 63 65 73 73 20 69 73 20 73 74 61 72 74 65 64  ocess is started
08a0: 20 61 6e 64 20 75 73 65 64 20 66 6f 72 20 6c 6f   and used for lo
08b0: 67 67 69 6e 67 0a 69 6e 73 74 65 61 64 20 6f 66  gging.instead of
08c0: 20 61 20 66 69 6c 65 2e 0a 0a 2e 54 50 0a 2e 42   a file....TP..B
08d0: 20 2d 75 20 28 6f 72 20 2d 2d 75 73 65 72 29 0a   -u (or --user).
08e0: 53 70 65 63 69 66 69 65 73 20 74 68 65 20 75 73  Specifies the us
08f0: 65 72 20 74 6f 20 73 77 69 74 63 68 20 75 73 65  er to switch use
0900: 72 20 49 44 73 20 74 6f 20 62 65 66 6f 72 65 20  r IDs to before 
0910: 73 65 72 76 69 63 69 6e 67 0a 72 65 71 75 65 73  servicing.reques
0920: 74 73 2e 20 20 54 68 65 20 64 65 66 61 75 6c 74  ts.  The default
0930: 20 69 73 20 6e 6f 74 20 63 68 61 6e 67 65 20 75   is not change u
0940: 73 65 72 20 49 44 73 2e 0a 0a 2e 54 50 0a 2e 42  ser IDs....TP..B
0950: 20 2d 72 20 28 6f 72 20 2d 2d 72 6f 6f 74 29 0a   -r (or --root).
0960: 53 70 65 63 69 66 69 65 73 20 74 68 65 20 64 69  Specifies the di
0970: 72 65 63 74 6f 72 79 20 74 6f 20 61 63 74 20 61  rectory to act a
0980: 73 20 74 68 65 20 72 6f 6f 74 20 64 69 72 65 63  s the root direc
0990: 74 6f 72 79 20 66 6f 72 0a 74 68 65 20 66 69 6c  tory for.the fil
09a0: 65 20 73 65 72 76 65 72 2e 20 20 49 66 20 74 68  e server.  If th
09b0: 69 73 20 6f 70 74 69 6f 6e 20 69 73 20 73 70 65  is option is spe
09c0: 63 69 66 69 65 64 2c 20 63 68 72 6f 6f 74 28 32  cified, chroot(2
09d0: 29 0a 69 73 20 63 61 6c 6c 65 64 2e 20 20 54 68  ).is called.  Th
09e0: 65 20 64 65 66 61 75 6c 74 20 69 73 20 6e 6f 74  e default is not
09f0: 20 63 68 61 6e 67 65 20 72 6f 6f 74 20 64 69 72   change root dir
0a00: 65 63 74 6f 72 69 65 73 2c 0a 74 68 61 74 20 69  ectories,.that i
0a10: 73 2c 20 74 68 65 20 22 2f 22 20 64 69 72 65 63  s, the "/" direc
0a20: 74 6f 72 79 20 69 73 20 73 68 61 72 65 64 20 6f  tory is shared o
0a30: 75 74 2e 20 20 54 68 69 73 20 77 69 6c 6c 0a 6c  ut.  This will.l
0a40: 69 6b 65 6c 79 20 62 65 20 61 20 73 65 63 75 72  ikely be a secur
0a50: 69 74 79 20 69 73 73 75 65 2c 20 73 6f 20 74 68  ity issue, so th
0a60: 69 73 20 6f 70 74 69 6f 6e 20 73 68 6f 75 6c 64  is option should
0a70: 20 61 6c 77 61 79 73 0a 62 65 20 75 73 65 64 2e   always.be used.
0a80: 0a 0a 2e 53 48 20 41 55 54 48 4f 52 0a 2e 53 70  ...SH AUTHOR..Sp
0a90: 0a 52 6f 79 20 4b 65 65 6e 65 0a 2e 49 20 3c 66  .Roy Keene..I <f
0aa0: 69 6c 65 64 40 72 6b 65 65 6e 65 2e 6f 72 67 3e  iled@rkeene.org>
0ab0: 0a                                               .