NAME

Unix::AutomountFile - Perl interface to automounter files

SYNOPSIS

  use Unix::AutomountFile;

  $am = new Unix::AutomountFile "/etc/auto_home";
  $am->automount("newuser", "fileserver:/export/home/&");
  $am->options("newuser", "-rw,nosuid");
  $am->delete("olduser");
  $am->commit();
  undef $am;

DESCRIPTION

The Unix::AutomountFile module provides an abstract interface to automounter files. It automatically handles file locking, getting colons and commas in the right places, and all the other niggling details. WARNING: This module is probably Solaris specific at this point. I have only looked at Solaris format automount files thus far. Also, you cannot edit /etc/auto_master with this module, since it is in a different format than the other automount files.

METHODS

add_server( MOUNT, @SERVERS )

This method will add additional servers to an existing automount point. It returns 1 on success and 0 on failure.

automount( MOUNT [,@SERVERS] )

This method can add, modify, or return information about a mount point. Supplied with a single mount parameter, it will return a list of the server entries for that mount point, or undef if no such mount exists. If you supply more than one parameter, the mount point will be created or modified if it already exists. The list is also returned to you in this case.

automounts( )

This method returns a list of all existing mount points, sorted alphabetically. In scalar context, this method returns the total number of mount points.

commit( [BACKUPEXT] )

See the Unix::ConfigFile documentation for a description of this method.

delete( MOUNT )

This method will delete the named mount point. It has no effect if the supplied mount point does not exist.

new( FILENAME [,OPTIONS] )

See the Unix::ConfigFile documentation for a description of this method.

options( MOUNT [,OPTIONS] )

Read or modify the mount options associated with a mount point. Returns the options in either case.

rename( OLDNAME, NEWNAME )

Renames a mount point. If NEWNAME corresponds to an existing mount point, that mount point is overwritten. Returns 0 on failure and 1 on success.

AUTHOR

Steve Snodgrass, ssnodgra@fore.com

SEE ALSO

Unix::AliasFile, Unix::ConfigFile, Unix::GroupFile, Unix::PasswdFile