Manual Reference Pages - FAM (1)
fam - file alteration monitor
/usr/etc/fam [ -f | -v | -d ] [ -l |
-t NFS_polling_interval ]
[ -T idle_timeout ] [ -p
program.version ] [ -L ] [ -C ]
[ -c config_file ]
fam is a server that tracks changes to the filesystem and
relays these changes to interested applications.
Applications such as
fm(1G) and mailbox(1) present an up-to-date view of the filesystem.
In the absence of fam, these applications and others like them
are forced to poll the filesystem to detect changes.
Applications can request fam to monitor any files or directories in
When fam detects changes to monitored files, it notifies
the appropriate application.
The FAM API provides a programmatic interface to fam; see
fam is informed of filesystem changes as they happen by the
kernel through the imon(7M) pseudo device driver.
If asked to
monitor files on an NFS mounted filesystem, fam tries to use
fam on the NFS server to monitor files.
If fam cannot
contact a remote fam, it polls the files instead.
fam also polls special files.
Normally, fam is started by inetd(1M).
It is registered with
portmap(1M) as performing the sgi_fam service.
Disable polling of NFS
It does not disable use of remote fam on NFS servers,
nor does it disable polling of local files.
Set the interval for polling files to NFS_polling_interval seconds.
is six seconds.
Set the idle timeout interval to idle_timeout.
fam exits idle_timeout seconds after its
last client disconnects.
A value of 0 causes fam to wait indefinitely for new connections.
The default is five seconds.
Remain in the foreground instead of spawning a child and exiting.
This option is ignored if fam is started by inetd.
Turn on verbose messages.
Enable verbose messages and debug messages.
Use the specified RPC program and version numbers.
Local-only mode. fam will only accept requests from clients running on the
local machine. This overrides the local_only flag in the configuration
file. This option is ignored if fam is started by inetd.
Compatibility mode. This disables authentication and reduces access security
as described under SECURITY below. This overrides the
insecure_compatibility flag in the configuration file.
Read configuration information from the given file rather than the default,
which is /usr/local/etc/fam.conf.
In addition to its command-line options, fams behavior can also be
controlled through its configuration file. By default, this is
/usr/local/etc/fam.conf; the -c command-line option can be used to specify
an alternate file. Configuration lines are in the format option=value.
Lines beginning with # or ! are ignored.
fam recognizes the following options:
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
This is the user name or UID of the user account which fam will use for
unauthenticated clients. If a file cant be stated by this user,
fam will not tell unauthenticated clients about the files existence.
If an untrusted user is not given in the configuration file, fam will
write an error message to the system log and terminate.
If set to true, fam will ignore requests from remote fams.
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
fam is started by inetd.
This is the time in seconds that fam will wait before exiting after its last
client disconnects. The default is five seconds. This option is overridden
by the -T command-line option.
This is the interval in seconds between polling files over an NFS filesystem.
The default is six seconds. This option is overridden by the -t
If set to true, fam 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, fam 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.
For backward compatibility, the -C command-line option and
insecure_compatibility configuration option can be used to disable
authentication. Configuring fam this way opens a publically known
security weakness whereby a "rogue client" can obtain the names of all the
files and directories on the system.
Note that fam never opens the files its monitoring, and cannot
be used by a rogue client to read the contents of any file on the system.
fam only gives out the names of monitored files, and only monitors files
which the client can
Users can stat a file without having read permission on it as long as
they have search permission on the directory containing it.
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.