Changeset 2238

Show
Ignore:
Timestamp:
08/29/08 00:09:32 (3 months ago)
Author:
mbr
Message:

dash fixes from Franck

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • psad/trunk/CREDITS

    r2234 r2238  
    390390    - Suggested moving dependencies into the deps/ directory to build a common 
    391391      architecture for bundling the cipherdyne.org projects for Debian. 
     392    - Submitted patches for documentation fixes in various psad man pages. 
    392393 
    393394Erik Heidt 
  • psad/trunk/psad.8

    r2150 r2238  
    7474.B /var/log/psad/fwdata 
    7575is parsed for old scans, but any file can be specified through the use 
    76 of the --messages-file command line option.  For example it might be useful 
     76of the \-\-messages-file command line option.  For example it might be useful 
    7777to point psad at your 
    7878.B /var/log/messages 
     
    139139.BR \-m "\fR,\fP " \-\^\-messages-file\ \<file> 
    140140This option is used to specify the file that will be parsed in analysis 
    141 mode (see the --Analyze-msgs option).  The default path is the psad 
     141mode (see the \-\-Analyze-msgs option).  The default path is the psad 
    142142data file 
    143143.B /var/log/psad/fwdata. 
     
    187187.BR \-B ", " \-\^\-Benchmark 
    188188Run psad in benchmark mode.  By default benchmark mode will simulate 
    189 a scan of 10,000 packets (see the --packets option) and then report 
     189a scan of 10,000 packets (see the \-\-packets option) and then report 
    190190the elapsed time.  This is useful to see how fast psad can process 
    191191packets on a specific machine. 
     
    209209can be made to 
    210210override this path by specifying a different file on the command 
    211 line with the --config option. 
     211line with the \-\-config option. 
    212212.TP 
    213213.BR \-\^\-signatures\ \<signatures-file> 
     
    223223system.  New signatures can be included and modifications to existing 
    224224signatures can be made to the signature file and psad will import 
    225 the changes upon receiving a HUP signal (see the --HUP command line 
     225the changes upon receiving a HUP signal (see the \-\-HUP command line 
    226226option) without having to restart the psad process. 
    227227.B psad 
     
    230230.TP 
    231231.BR \-e ", " \-\^\-email-analysis 
    232 Send alert emails when run in --Analyze-msgs mode.  Depending on the size of 
    233 the iptables logfile, using the --email-analysis option could extend the runtime 
     232Send alert emails when run in \-\-Analyze-msgs mode.  Depending on the size of 
     233the iptables logfile, using the \-\-email-analysis option could extend the runtime 
    234234of psad by quite a bit since normally both DNS and whois lookups will be issued 
    235235against each scanning IP address.  As usual these lookups can be disabled with 
    236 the --no-rdns and --no-whois options respectively. 
     236the \-\-no-rdns and \-\-no-whois options respectively. 
    237237.TP 
    238238.BR \-w ", " \-\^\-whois-analysis 
    239239By default 
    240240.B psad 
    241 does not issue whois lookups when running in --Analyze-msgs mode.  The 
    242 --whois-analysis option will override this behavior (when run in analysis mode) 
     241does not issue whois lookups when running in \-\-Analyze-msgs mode.  The 
     242\-\-whois-analysis option will override this behavior (when run in analysis mode) 
    243243and instruct psad to issue whois lookups against IP addresses from which scans 
    244244or other suspect traffic has originated. 
     
    281281can be made to 
    282282override this path by specifying a different file on the command 
    283 line with the --fw-search option. 
     283line with the \-\-fw-search option. 
    284284.TP 
    285285.BR \-\^\-fw-list-auto 
     
    296296.B psad 
    297297will not delete the auto-generated iptables chains (see the IPT_AUTO_CHAIN 
    298 keywords in psad.conf) if the --Flush option is given.  The --fw-del-chains 
     298keywords in psad.conf) if the \-\-Flush option is given.  The \-\-fw-del-chains 
    299299option overrides this behavior and deletes the auto-blocking chains from a 
    300300running iptables firewall. 
     
    306306system.  All IP addresses are removed from the resulting output, so it is 
    307307safe to post to the psad list, or communicate to others.  This option is 
    308 most often used with --Dump-conf. 
     308most often used with \-\-Dump-conf. 
    309309.TP 
    310310.BR \-\^\-fw-block-ip\ \<ip> 
     
    375375a .gnu file by convention).  Normally 
    376376.B psad builds all of the graphing directives based on various --gnuplot 
    377 command line arguments, but the --gnuplot-template switch allows you to 
     377command line arguments, but the \-\-gnuplot-template switch allows you to 
    378378override this behavior. 
    379379.TP 
     
    454454will write these message to 
    455455.B /var/log/psad/errs/fwerrorlog 
    456 by default.  Passing the --no-ipt-errors option will make psad ignore 
     456by default.  Passing the \-\-no-ipt-errors option will make psad ignore 
    457457all such erroneous firewall messages. 
    458458.TP 
    459459.BR \-\^\-no-whois 
    460460By default psad will issue a whois query against any IP from which 
    461 a scan has originated, but this can be disabled with the --no-whois 
     461a scan has originated, but this can be disabled with the \-\-no-whois 
    462462command line argument. 
    463463.TP 
     
    467467whether or not the firewall has a compatible configuration (i.e. 
    468468iptables has been configured to log packets).  Passing the 
    469 --no-fwcheck or --log-server options will disable this check. 
     469\-\-no-fwcheck or \-\-log-server options will disable this check. 
    470470.TP 
    471471.BR \-\^\-no-auto-dl 
     
    492492By default psad will attempt to passively (i.e. without sending 
    493493any packets) fingerprint the remote operating system from which 
    494 a scan originates.  Passing the --no-passive-os option will 
     494a scan originates.  Passing the \-\-no-passive-os option will 
    495495disable this feature. 
    496496.TP 
     
    499499normally attempts to find the name associated with a 
    500500scanning IP address, but this feature can be disabled with 
    501 the --no-rdns command line argument. 
     501the \-\-no-rdns command line argument. 
    502502.TP 
    503503.BR \-\^\-no-kmsgsd 
     
    511511By default for iptables firewalls psad will determine whether 
    512512or not your machine is listening on a port for which a TCP 
    513 signature has been matched.  Specifying --no-netstat 
     513signature has been matched.  Specifying \-\-no-netstat 
    514514disables this feature. 
    515515.TP 
     
    531531employ to parse iptables messages.  Using configuration directive within 
    532532this file, psad can be configured to parse all iptables messages or only 
    533 those that match specific log prefix strings (see the --log-prefix option 
     533those that match specific log prefix strings (see the \-\-log-prefix option 
    534534to iptables). 
    535535.RE 
     
    553553.B /etc/psad/snort_rules/*.rules 
    554554.RS 
    555 Snort rules files that are consulted by default unless the --no-snort-sids 
     555Snort rules files that are consulted by default unless the \-\-no-snort-sids 
    556556commmand line argument is given. 
    557557.RE 
     
    623623scan activity.  However, if FW_SEARCH_ALL is set to "N", psad 
    624624will only parse those iptables log messages that match certain search 
    625 strings that appear in iptables logs with the --log-prefix option.  This is 
     625strings that appear in iptables logs with the \-\-log-prefix option.  This is 
    626626useful for restricting psad to only operate on specific iptables chains or 
    627627rules.  The strings that will be searched for are defined with the FW_MSG_SEARCH 
     
    635635uses to identify iptables messages that should be parsed for scan activity. 
    636636These search strings should match the log prefix strings specified 
    637 in the iptables ruleset with the --log-prefix option, and the default value 
     637in the iptables ruleset with the \-\-log-prefix option, and the default value 
    638638for FW_MSG_SEARCH is "DROP".  Note that 
    639639.B psad 
     
    796796to analyzing the 
    797797.B /var/log/messages 
    798 file if the -m option is not specified): 
     798file if the \-m option is not specified): 
    799799.PP 
    800800.B # psad -A -m <iptables logfile> 
     
    836836allowed should be blocked by the firewall ruleset.  By default, psad attempts 
    837837to determine whether or not the firewall has been configured in this way.  This 
    838 feature can be disabled with the --no-fwcheck or --log-server options.  The 
    839 --log-server option is useful if psad is running on a syslog logging server 
     838feature can be disabled with the \-\-no-fwcheck or \-\-log-server options.  The 
     839\-\-log-server option is useful if psad is running on a syslog logging server 
    840840that is separate from the firewall.  For more information on compatible iptables 
    841841rulesets, see the 
     
    853853this file. 
    854854.SH DIAGNOSTICS 
    855 The --debug option can be used to display crucial information 
     855The \-\-debug option can be used to display crucial information 
    856856about the psad data structures on STDOUT as a scan generates firewall 
    857 log messages.  --debug disables daemon mode execution. 
     857log messages.  \-\-debug disables daemon mode execution. 
    858858.PP 
    859859Another more effective way to peer into the runtime execution of psad 
     
    886886always welcome as well. 
    887887.PP 
    888 -For iptables firewalls as of Linux kernel version 2.4.26, if the ip_conntrack 
     888For iptables firewalls as of Linux kernel version 2.4.26, if the ip_conntrack 
    889889module is loaded (or compiled into the kernel) and the firewall has been 
    890890configured to keep state of connections, occasionally packets that are supposed