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