famd(8) [debian man page]

FAMD(8) 								SGI								   FAMD(8)

NAME

       famd - The File Alteration Monitor (FAM) daemon

SYNOPSIS

       famd [-CdflLv] [-C conffile] [-p prog.vers] [-t period] [-T timeout]

DESCRIPTION

       FAM,  the  File Alteration Monitor, is a subsystem that applications can use to be notified when specific files or directories are changed.
       It is intended as a replacement for mechanisms such as poll and select.

       FAM comes in two parts: famd, the daemon that listens for requests and provides notifications, and libfam a library  that  client  applica-
       tions can use to communicate with FAM.  For further information on libfam, see the fam(3) manual page.

       famd  is  normally started by an Internet superserver such as inetd or xinetd, but can also be started independently.  Only one instance of
       famd can be run at a time.

       famd can be configured by editing the famd configuration file (see fam.conf(5) for further details) or by providing the	following  command
       line options:

OPTIONS

       -c conffile
	      Read configuration information from conffile.

       -C     Run in backwards compatibilty mode.  This is disables authentication and is not recommended.

       -f     Run in the foreground.

       -v     Enable verbose messages.

       -d     Enable verbose messages and debug messages.

       -l     Disable polling of files on remote NFS servers.

       -L     Only accept connections from local clients.

       -r     Detect read-only filesystems.

       -p prog.vers
	      Register with the portmapper using the specifed RPC program and version numbers.

       -P port
	      Bind to the specified TCP port instead of choosing at random.

       -t period
	      Poll a remove NFS server every period seconds to obtain file updates if the remove server is not running famd.

       -T timeout
	      Exit timeout seconds after the last client disconnects.  A value of 0 causes famd to run forever.

SECURITY

       famd never opens the files it's monitoring, and only monitors files that the client can stat.

FILES

       /etc/fam.conf
	      Default famd configuration file.

SEE ALSO

       fam(3), fam.conf(5), inetd(8), portmap(8), stat(1), xinetd(8)

BUGS

famd (fam 2.6.10)						 January 19, 2003							   FAMD(8)

FAM.CONF(5)								SGI							       FAM.CONF(5)

NAME

       fam.conf - The File Alteration Monitor (FAM) configuration file

SYNOPSIS

       In  addition  to  its  command  line  options,  famd's behavior can also be controlled through its configuration file.  By default, this is
       /etc/fam.conf.  The -c command line option can be used to specify an alternate file.

FILE FORMAT

       Configuration lines are in the format option=value.  Lines beginning with # or ! are ignored.  famd recognizes the following options:

       insecure_compatibility	 If set to true, this disables authentication and reduces access security as described under SECURITY below.  This
				 is false by default.  Setting this option to true is the same as using the -C command line option.

       untrusted_user		 This  is  the	user  name  or UID of the user account which famd will use for unauthenticated clients.  If a file
				 can't be stated by this user, famd will not tell unauthenticated clients  about  the  file's  existence.   If	an
				 untrusted  user  is  not  given in the configuration file, famd will write an error message to the system log and
				 terminate.

       local_only		 If set to true, famd will ignore requests from remote famds.  This is false by default.  Setting this	option	to
				 true is the same as using the -L command line option.	This option is ignored if famd is started by inetd.

       idle_timeout		 This is the time in seconds that famd will wait before exiting after its last client disconnects.  The default is
				 5 seconds.  This option is overridden by the -T command line option.

       nfs_polling_interval	 This is the interval in seconds between polling files over an NFS filesystem.	The default is	6  seconds.   This
				 option is overridden by the -t command line option.

       xtab_verification	 If set to true, famd will check the list of exported filesystems when remote requests are received to verify that
				 the requests fall on filesystems which are exported to the requesting hosts.  This is true by default.   If  this
				 option is set to false, famd will service remote requests without attempting to perform the verification.  If the
				 local_only configuration option or -L command line option is used, xtab_verification has no effect.

       detect_readonly_filesystems
				 If set to true, famd will try to detect read-only filesystems.  Such filesystems are  assumed	to  never  change.
				 This is false by default.  Setting this option to true is the same as using the -r command line option.

SEE ALSO

fam.conf (fam 2.6.10)						 January 19, 2003						       FAM.CONF(5)