1FIDO(8) User Contributed Perl Documentation FIDO(8)
2
3
4
6 fido is a realish-time log watchdog and alert daemon.
7
9 fido [option]
10
12 fido is a multi-threaded daemon that can watch several files at once.
13 It looks for patterns that you configure and executes scripts or pro‐
14 grams in the event of a match. fido works in "realish-time" in that it
15 is about a second or so behind the clock.
16
18 Option Syntax
19
20 Since fido uses GNU getopt to process command-line arguments, every
21 option has a long form along with the short one. Long options are more
22 convenient to remember, but take time to type. You may freely mix dif‐
23 ferent option styles, i.e.,
24
25 $ fido -d --pid=/var/run/fido.pid
26
27 Startup Options
28
29 -V, --version
30 Display the version of fido and exit.
31
32 -h, --help
33 Print a help message describing all of fido's command-line options
34 and exit.
35
36 -C, --config
37 Prints the default values for all configurable settings. Values are
38 read from the active resource file and command line arguements.
39
40 -f /path/file, --file=/path/file
41 This option can be used to specify a fido config file. If none is
42 selected it will attempt to load FIDORC as an ENV variable. If
43 FIDORC is not set, then it will attempt the following files in this
44 order:
45
46 /etc/fido/fido.conf
47 /etc/fido.conf
48 /usr/local/etc/fido.conf
49 /usr/local/etc/fido/fido.conf
50
51 At this point, if fido hasn't found a config file, it will try to
52 run off command line arguments. NOTE: Command line arguments take
53 precedent over config file settings.
54
55 -d, --daemon
56 This options tells fido to run in the background as a daemon. This
57 is a default option so select this to override the config file.
58
59 Sets the network protocol to ICMP. During a netscan, fido can use
60 either ICMP echo (default) or TCP/IP connect for discovery. This
61 option sets the protocol to ICMP. This option is like pinging
62 hosts on a network with the ping utility. ICMP requires raw sock‐
63 ets. Therefore, fido must either be run as root or setuid root.
64 (see ERRORS below).
65
66 -p /path/file, --pid=/path/file
67 By default, fido writes a pid file to /var/run/fido.pid You may
68 override that location with this option, fido
69 --pid=/var/lib/run/fido.pid
70
71 -l VAL, --log=VAL
72 Use this option to specify a logging method. The values can be
73 "/path/to/file" or "syslog" fido can either log its messages to
74 syslog or it can use its own internal logging mechanism to write to
75 a specified file.
76
78 fido's configurable options can be set and stored in config files.
79 All stored settings can be overridden with command line arguments.
80 If a logging mechanism is set in config file, it can be overridden
81 with --log. fido reads config files in a priortized fashion. The
82 ENV variable FIDORC is the highest. That is followed by '-f
83 /path/file' and by the system defaults:
84
85 /etc/fido/fido.conf
86 /etc/fido.conf
87 /usr/local/etc/fido.conf
88 /usr/local/etc/fido/fido.conf
89
90 Here is an example that sets an ENV variable and invokes the pro‐
91 gram:
92
93 $ FIDORC=/home/jeff/haha fido -d
94
96 Jeffrey Fulmer, et al. <jeff@joedog.org>
97
99 fido.conf(5)
100
102 Copyright (C) 2000-2014 by Jeffrey Fulmer, et al.
103
104 This is free software; see the source for copying conditions.
105 There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
106 PARTICULAR PURPOSE.
107
108
109
110perl v5.8.8 2014-12-03 FIDO(8)