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