Hex Artifact Content

Artifact 9ce09cb60c41cac29cda0acefb5df813c0cc9434:


0000: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0010: 20 49 6e 73 74 61 6c 6c 69 6e 67 20 50 61 63 6b   Installing Pack
0020: 65 74 42 4c 0a 0a 54 61 62 6c 65 20 6f 66 20 43  etBL..Table of C
0030: 6f 6e 74 65 6e 74 73 3a 0a 09 49 2e 20 20 20 4e  ontents:..I.   N
0040: 6f 74 65 73 0a 09 49 49 2e 20 20 50 72 65 72 65  otes..II.  Prere
0050: 71 75 69 73 69 74 65 73 0a 09 49 49 49 2e 20 49  quisites..III. I
0060: 6e 73 74 61 6c 6c 61 74 69 6f 6e 0a 09 49 56 2e  nstallation..IV.
0070: 20 20 43 6f 6e 66 69 67 75 72 61 74 69 6f 6e 0a    Configuration.
0080: 09 56 2e 20 20 20 43 6f 6d 6d 61 6e 64 20 4c 69  .V.   Command Li
0090: 6e 65 20 41 72 67 75 6d 65 6e 74 73 0a 0a 0a 49  ne Arguments...I
00a0: 2e 20 4e 4f 54 45 53 0a 09 2a 4e 4f 54 45 2a 20  . NOTES..*NOTE* 
00b0: 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 6d 61  This document ma
00c0: 79 20 76 65 72 79 20 77 69 6c 6c 20 62 65 20 69  y very will be i
00d0: 6e 61 63 63 75 72 61 74 65 2c 20 69 66 20 61 74  naccurate, if at
00e0: 20 61 6c 6c 20 70 6f 73 73 69 62 6c 65 0a 09 79   all possible..y
00f0: 6f 75 20 73 68 6f 75 6c 64 20 72 65 66 65 72 20  ou should refer 
0100: 74 6f 0a 09 09 68 74 74 70 3a 2f 2f 77 77 77 2e  to...http://www.
0110: 72 6a 6d 73 6f 66 74 77 61 72 65 2e 6f 72 67 0a  rjmsoftware.org.
0120: 09 66 6f 72 20 61 75 74 68 6f 72 69 74 61 74 69  .for authoritati
0130: 76 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 20  ve information. 
0140: 20 41 6c 73 6f 20 66 65 65 6c 20 66 72 65 65 20   Also feel free 
0150: 74 6f 20 75 73 65 20 74 68 65 20 62 75 67 7a 69  to use the bugzi
0160: 6c 6c 61 20 74 6f 0a 09 09 72 65 70 6f 72 74 20  lla to...report 
0170: 62 75 67 73 2f 61 73 6b 20 66 6f 72 20 66 65 61  bugs/ask for fea
0180: 74 75 72 65 73 2e 20 20 49 20 68 61 76 65 20 74  tures.  I have t
0190: 75 72 6e 65 64 20 6f 66 66 20 74 68 65 20 6d 61  urned off the ma
01a0: 69 6c 69 6e 67 0a 09 09 6c 69 73 74 20 64 75 65  iling...list due
01b0: 20 74 6f 20 73 70 61 6d 2e 0a 0a 49 49 2e 20 50   to spam...II. P
01c0: 52 45 52 45 51 55 49 53 49 54 45 53 0a 09 31 2e  REREQUISITES..1.
01d0: 20 6c 69 62 63 6f 6e 66 69 67 20 28 72 65 71 75   libconfig (requ
01e0: 69 72 65 64 29 0a 0a 09 32 2e 20 69 70 74 61 62  ired)...2. iptab
01f0: 6c 65 73 20 28 72 65 71 75 69 72 65 64 29 0a 09  les (required)..
0200: 09 49 70 74 61 62 6c 65 73 27 20 6c 69 62 72 61  .Iptables' libra
0210: 72 79 20 22 69 70 71 22 20 28 49 50 20 51 75 65  ry "ipq" (IP Que
0220: 75 69 6e 67 20 6c 69 62 72 61 72 79 29 20 69 73  uing library) is
0230: 20 72 65 71 75 69 72 65 64 2c 20 69 74 0a 09 09   required, it...
0240: 70 72 6f 76 69 64 65 73 20 74 68 65 20 6e 65 63  provides the nec
0250: 65 73 73 61 72 79 20 68 6f 6f 6b 73 20 74 6f 20  essary hooks to 
0260: 61 6c 6c 6f 77 20 50 61 63 6b 65 74 42 4c 20 74  allow PacketBL t
0270: 6f 20 61 63 63 65 70 74 0a 09 09 70 61 63 6b 65  o accept...packe
0280: 74 73 20 66 72 6f 6d 20 74 68 65 20 51 55 45 55  ts from the QUEU
0290: 45 20 74 61 72 67 65 74 20 61 6e 64 20 70 72 6f  E target and pro
02a0: 63 65 73 73 20 74 68 65 6d 2e 0a 0a 09 33 2e 20  cess them....3. 
02b0: 46 69 72 65 44 4e 53 20 28 6f 70 74 69 6f 6e 61  FireDNS (optiona
02c0: 6c 29 0a 09 09 46 69 72 65 44 4e 53 20 69 73 20  l)...FireDNS is 
02d0: 61 20 6c 69 62 72 61 72 79 20 74 68 61 74 20 71  a library that q
02e0: 75 65 72 69 65 73 20 61 6c 6c 20 63 6f 6e 66 69  ueries all confi
02f0: 67 75 72 65 64 20 6e 61 6d 65 73 65 72 76 65 72  gured nameserver
0300: 73 20 69 6e 0a 09 09 70 61 72 61 6c 6c 65 6c 20  s in...parallel 
0310: 61 6e 64 20 6f 6e 63 65 20 69 74 20 67 65 74 73  and once it gets
0320: 20 61 6e 20 61 6e 73 77 65 72 20 66 72 6f 6d 20   an answer from 
0330: 6f 6e 65 20 6f 66 20 74 68 65 6d 20 72 65 70 6f  one of them repo
0340: 72 74 73 0a 09 09 74 68 69 73 2e 20 20 49 74 20  rts...this.  It 
0350: 63 61 6e 20 6d 61 6b 65 20 6e 61 6d 65 20 72 65  can make name re
0360: 73 6f 6c 75 74 69 6f 6e 20 4d 55 43 48 20 66 61  solution MUCH fa
0370: 73 74 65 72 2c 20 65 73 70 65 63 69 61 6c 6c 79  ster, especially
0380: 20 77 68 65 6e 0a 09 09 61 20 63 6f 6e 66 69 67   when...a config
0390: 75 72 65 64 20 6e 61 6d 65 73 65 72 76 65 72 20  ured nameserver 
03a0: 69 73 20 75 6e 72 65 61 63 68 61 62 6c 65 20 6f  is unreachable o
03b0: 72 20 64 6f 77 6e 2e 0a 0a 49 49 49 2e 20 49 4e  r down...III. IN
03c0: 53 54 41 4c 4c 41 54 49 4f 4e 0a 09 31 2e 20 50  STALLATION..1. P
03d0: 61 63 6b 65 74 42 4c 20 75 73 65 73 20 61 20 47  acketBL uses a G
03e0: 4e 55 20 61 75 74 6f 63 6f 6e 66 20 73 74 79 6c  NU autoconf styl
03f0: 65 20 60 63 6f 6e 66 69 67 75 72 65 27 20 73 63  e `configure' sc
0400: 72 69 70 74 20 66 6f 72 0a 09 20 20 20 63 6f 6e  ript for..   con
0410: 66 69 67 75 72 61 74 69 6f 6e 2e 20 20 54 6f 20  figuration.  To 
0420: 69 6e 76 6f 6b 65 20 74 68 69 73 20 73 63 72 69  invoke this scri
0430: 70 74 20 72 75 6e 20 74 68 65 20 60 63 6f 6e 66  pt run the `conf
0440: 69 67 75 72 65 27 20 73 63 72 69 70 74 0a 09 20  igure' script.. 
0450: 20 20 77 69 74 68 69 6e 20 74 68 65 20 74 6f 70    within the top
0460: 2d 6c 65 76 65 6c 20 73 6f 75 72 63 65 20 64 69  -level source di
0470: 72 65 63 74 6f 72 79 2c 20 66 6f 72 20 65 78 61  rectory, for exa
0480: 6d 70 6c 65 3a 0a 09 09 2e 2f 63 6f 6e 66 69 67  mple:..../config
0490: 75 72 65 0a 09 20 20 20 54 68 65 72 65 20 61 72  ure..   There ar
04a0: 65 20 61 20 66 65 77 20 6f 70 74 69 6f 6e 73 20  e a few options 
04b0: 74 68 61 74 20 63 61 6e 20 62 65 20 70 61 73 73  that can be pass
04c0: 65 64 20 74 6f 20 74 68 65 20 60 63 6f 6e 66 69  ed to the `confi
04d0: 67 75 72 65 27 20 73 63 72 69 70 74 0a 09 20 20  gure' script..  
04e0: 20 74 68 61 74 20 77 69 6c 6c 20 61 66 66 65 63   that will affec
04f0: 74 20 74 68 65 20 77 61 79 20 50 61 63 6b 65 74  t the way Packet
0500: 42 4c 20 69 73 20 62 75 69 6c 74 20 28 69 6e 20  BL is built (in 
0510: 61 64 64 69 74 69 6f 6e 20 74 6f 20 74 68 65 0a  addition to the.
0520: 09 20 20 20 73 74 61 6e 64 61 72 64 20 61 75 74  .   standard aut
0530: 6f 63 6f 6e 66 20 60 63 6f 6e 66 69 67 75 72 65  oconf `configure
0540: 27 20 73 63 72 69 70 74 20 6f 70 74 69 6f 6e 73  ' script options
0550: 29 3a 0a 09 09 61 2e 20 2d 2d 77 69 74 68 2d 63  ):...a. --with-c
0560: 61 63 68 65 0a 09 09 09 54 68 69 73 20 6f 70 74  ache....This opt
0570: 69 6f 6e 20 77 69 6c 6c 20 65 6e 61 62 6c 65 20  ion will enable 
0580: 74 68 65 20 65 78 70 65 72 69 6d 65 6e 74 61 6c  the experimental
0590: 20 63 61 63 68 69 6e 67 0a 09 09 09 6d 65 63 68   caching....mech
05a0: 61 6e 69 73 6d 2e 20 20 54 68 69 73 20 6d 61 79  anism.  This may
05b0: 20 69 6e 74 72 6f 64 75 63 65 20 75 6e 65 78 70   introduce unexp
05c0: 65 63 74 65 64 20 70 72 6f 62 6c 65 6d 73 2e 0a  ected problems..
05d0: 09 09 09 49 66 20 79 6f 75 20 65 6e 63 6f 75 6e  ...If you encoun
05e0: 74 65 72 20 61 6e 79 20 70 72 6f 62 6c 65 6d 73  ter any problems
05f0: 20 79 6f 75 20 73 68 6f 75 6c 64 20 70 6f 73 74   you should post
0600: 20 61 20 62 75 67 0a 09 09 09 72 65 70 6f 72 74   a bug....report
0610: 20 74 6f 20 74 68 65 20 50 61 63 6b 65 74 42 4c   to the PacketBL
0620: 20 62 75 67 7a 69 6c 6c 61 20 28 66 6f 72 20 64   bugzilla (for d
0630: 65 74 61 69 6c 73 2c 20 73 65 65 0a 09 09 09 62  etails, see....b
0640: 75 67 7a 69 6c 6c 61 2e 72 6a 6d 73 6f 66 74 77  ugzilla.rjmsoftw
0650: 61 72 65 2e 6f 72 67 29 0a 09 09 62 2e 20 2d 2d  are.org)...b. --
0660: 77 69 74 68 2d 66 69 72 65 64 6e 73 0a 09 09 09  with-firedns....
0670: 54 68 69 73 20 6f 70 74 69 6f 6e 20 77 69 6c 6c  This option will
0680: 20 63 61 75 73 65 20 50 61 63 6b 65 74 42 4c 20   cause PacketBL 
0690: 74 6f 20 75 73 65 20 46 69 72 65 44 4e 53 27 73  to use FireDNS's
06a0: 20 6e 61 6d 65 0a 09 09 09 72 65 73 6f 6c 75 74   name....resolut
06b0: 69 6f 6e 20 72 6f 75 74 69 6e 65 73 20 77 68 65  ion routines whe
06c0: 6e 20 74 65 73 74 69 6e 67 20 49 50 73 20 61 67  n testing IPs ag
06d0: 61 69 6e 73 74 20 44 4e 53 20 52 42 4c 73 2e 0a  ainst DNS RBLs..
06e0: 09 09 09 52 65 61 64 20 61 62 6f 76 65 20 66 6f  ...Read above fo
06f0: 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69  r more informati
0700: 6f 6e 20 6f 6e 20 46 69 72 65 44 4e 53 2e 0a 09  on on FireDNS...
0710: 09 63 2e 20 2d 2d 77 69 74 68 2d 73 74 61 74 73  .c. --with-stats
0720: 0a 09 09 09 54 68 69 73 20 6f 70 74 69 6f 6e 20  ....This option 
0730: 77 69 6c 6c 20 65 6e 61 62 6c 65 20 74 68 65 20  will enable the 
0740: 65 78 70 65 72 69 6d 65 6e 74 61 6c 20 73 74 61  experimental sta
0750: 74 69 73 74 69 63 0a 09 09 09 67 61 74 68 65 72  tistic....gather
0760: 69 6e 67 20 63 6f 64 65 2c 20 77 68 69 63 68 20  ing code, which 
0770: 77 69 6c 6c 20 72 65 71 75 69 72 65 20 61 6e 20  will require an 
0780: 65 78 74 72 61 20 74 68 72 65 61 64 20 74 6f 0a  extra thread to.
0790: 09 09 09 68 61 6e 64 6c 65 20 69 6e 63 6f 6d 69  ...handle incomi
07a0: 6e 67 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 74  ng connections t
07b0: 6f 20 61 20 55 4e 49 58 20 64 6f 6d 61 69 6e 20  o a UNIX domain 
07c0: 73 6f 63 6b 65 74 2e 0a 09 09 64 2e 20 2d 2d 77  socket....d. --w
07d0: 69 74 68 2d 73 74 61 74 73 2d 73 6f 63 6b 65 74  ith-stats-socket
07e0: 3d 2f 70 61 74 68 2f 74 6f 2f 73 6f 63 6b 65 74  =/path/to/socket
07f0: 0a 09 09 09 54 68 69 73 20 6f 70 74 69 6f 6e 20  ....This option 
0800: 61 6c 6c 6f 77 73 20 6f 6e 65 20 74 6f 20 73 70  allows one to sp
0810: 65 63 69 66 79 20 74 68 65 20 70 61 74 68 20 74  ecify the path t
0820: 6f 20 74 68 65 20 55 4e 49 58 0a 09 09 09 64 6f  o the UNIX....do
0830: 6d 61 69 6e 20 73 6f 63 6b 65 74 20 74 68 61 74  main socket that
0840: 20 69 73 20 75 73 65 64 20 66 6f 72 20 63 6f 6d   is used for com
0850: 6d 75 6e 69 63 61 74 69 6f 6e 73 20 62 65 74 77  munications betw
0860: 65 65 6e 0a 09 09 09 74 68 65 20 50 61 63 6b 65  een....the Packe
0870: 74 42 4c 20 64 61 65 6d 6f 6e 20 61 6e 64 20 74  tBL daemon and t
0880: 68 65 20 22 70 61 63 6b 65 74 62 6c 5f 67 65 74  he "packetbl_get
0890: 73 74 61 74 22 20 70 72 6f 63 65 73 73 2e 0a 09  stat" process...
08a0: 09 09 44 65 66 61 75 6c 74 20 69 73 20 2f 74 6d  ..Default is /tm
08b0: 70 2f 2e 70 61 63 6b 65 74 62 6c 2e 73 6f 63 6b  p/.packetbl.sock
08c0: 2e 0a 0a 49 56 2e 20 43 4f 4e 46 49 47 55 52 41  ...IV. CONFIGURA
08d0: 54 49 4f 4e 0a 09 54 6f 20 62 65 20 72 65 70 6c  TION..To be repl
08e0: 61 63 65 64 2e 20 20 41 20 73 61 6d 70 6c 65 20  aced.  A sample 
08f0: 63 6f 6e 66 69 67 20 66 69 6c 65 20 69 73 20 70  config file is p
0900: 72 6f 76 69 64 65 64 2e 0a 0a 56 2e 20 43 4f 4d  rovided...V. COM
0910: 4d 41 4e 44 20 4c 49 4e 45 20 41 52 47 55 4d 45  MAND LINE ARGUME
0920: 4e 54 53 0a 09 31 2e 20 50 61 63 6b 65 74 42 4c  NTS..1. PacketBL
0930: 20 73 75 70 70 6f 72 74 73 20 61 20 6d 69 6e 69   supports a mini
0940: 6d 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f  mal number of co
0950: 6d 6d 61 6e 64 20 6c 69 6e 65 20 61 72 67 75 6d  mmand line argum
0960: 65 6e 74 73 2c 20 73 69 6e 63 65 0a 09 20 20 20  ents, since..   
0970: 6d 6f 73 74 20 63 6f 6e 66 69 67 75 72 61 74 69  most configurati
0980: 6f 6e 20 73 68 6f 75 6c 64 20 62 65 20 64 6f 6e  on should be don
0990: 65 20 69 6e 20 74 68 65 20 63 6f 6e 66 69 67 75  e in the configu
09a0: 72 61 74 69 6f 6e 20 66 69 6c 65 20 28 73 65 65  ration file (see
09b0: 0a 09 20 20 20 70 72 65 76 69 6f 75 73 20 73 65  ..   previous se
09c0: 63 74 69 6f 6e 29 2e 20 20 54 68 65 20 66 6f 6c  ction).  The fol
09d0: 6c 6f 77 69 6e 67 20 69 73 20 61 20 63 6f 6d 70  lowing is a comp
09e0: 6c 65 74 65 20 6c 69 73 74 20 6f 66 20 73 75 70  lete list of sup
09f0: 70 6f 72 74 65 64 0a 09 20 20 20 63 6f 6d 6d 61  ported..   comma
0a00: 6e 64 20 6c 69 6e 65 20 61 72 67 75 6d 65 6e 74  nd line argument
0a10: 73 3a 0a 09 09 61 2e 20 22 2d 71 22 0a 09 09 09  s:...a. "-q"....
0a20: 54 68 65 20 22 2d 71 22 20 6f 70 74 69 6f 6e 20  The "-q" option 
0a30: 63 61 75 73 65 73 20 50 61 63 6b 65 74 42 4c 20  causes PacketBL 
0a40: 74 6f 20 62 65 20 71 75 69 65 74 2c 20 69 74 20  to be quiet, it 
0a50: 69 73 0a 09 09 09 69 64 65 6e 74 69 63 61 6c 20  is....identical 
0a60: 74 6f 20 73 65 74 74 69 6e 67 20 22 51 75 69 65  to setting "Quie
0a70: 74 22 20 74 6f 20 22 79 65 73 22 20 69 6e 20 74  t" to "yes" in t
0a80: 68 65 0a 09 09 09 63 6f 6e 66 69 67 75 72 61 74  he....configurat
0a90: 69 6f 6e 20 66 69 6c 65 2e 0a 09 09 62 2e 20 22  ion file....b. "
0aa0: 2d 56 22 0a 09 09 09 54 68 65 20 22 2d 56 22 20  -V"....The "-V" 
0ab0: 6f 70 74 69 6f 6e 20 63 61 75 73 65 73 20 50 61  option causes Pa
0ac0: 63 6b 65 74 42 4c 20 74 6f 20 70 72 69 6e 74 20  cketBL to print 
0ad0: 6f 75 74 20 69 74 73 0a 09 09 09 76 65 72 73 69  out its....versi
0ae0: 6f 6e 20 6e 75 6d 62 65 72 20 61 6e 64 20 6f 74  on number and ot
0af0: 68 65 72 20 72 65 6c 65 76 61 6e 74 20 69 6e 66  her relevant inf
0b00: 6f 72 6d 61 74 69 6f 6e 20 74 6f 0a 09 09 09 73  ormation to....s
0b10: 74 61 6e 64 61 72 64 20 6f 75 74 70 75 74 20 61  tandard output a
0b20: 6e 64 20 65 78 69 74 20 73 75 63 63 65 73 73 66  nd exit successf
0b30: 75 6c 6c 79 2e 0a 09 20 20 20 43 6f 6d 6d 61 6e  ully...   Comman
0b40: 64 20 6c 69 6e 65 20 61 72 67 75 6d 65 6e 74 73  d line arguments
0b50: 20 61 6c 77 61 79 73 20 6f 76 65 72 72 69 64 65   always override
0b60: 20 74 68 65 69 72 20 63 6f 6e 66 69 67 75 72 61   their configura
0b70: 74 69 6f 6e 20 66 69 6c 65 0a 09 20 20 20 63 6f  tion file..   co
0b80: 75 6e 74 65 72 2d 70 61 72 74 73 20 77 68 65 72  unter-parts wher
0b90: 65 20 61 70 70 72 6f 70 72 69 61 74 65 2e 20 20  e appropriate.  
0ba0: 55 6e 6b 6e 6f 77 6e 20 63 6f 6d 6d 61 6e 64 20  Unknown command 
0bb0: 6c 69 6e 65 20 61 72 67 75 6d 65 6e 74 73 0a 09  line arguments..
0bc0: 20 20 20 63 61 75 73 65 20 50 61 63 6b 65 74 42     cause PacketB
0bd0: 4c 20 74 6f 20 74 65 72 6d 69 6e 61 74 65 20 69  L to terminate i
0be0: 6e 20 65 72 72 6f 72 20 69 6d 6d 65 64 69 61 74  n error immediat
0bf0: 65 6c 79 20 61 74 20 73 74 61 72 74 75 70 2e 0a  ely at startup..