putdgrp(1)                                                       putdgrp(1)


   NAME
         putdgrp - edits device group table

   SYNOPSIS
         putdgrp [-d] dgroup [device [...]]

   DESCRIPTION
         putdgrp modifies the device group table.  It performs two kinds of
         modification.  It can modify the table by creating a new device group
         or removing a device group.  It can also change group definitions by
         adding or removing a device from the group definition.

         When the command is invoked with only a dgroup specification, the
         command adds the specified group name to the device group table if it
         does not already exist.  If the -d option is also used with only the
         dgroup specification, the command deletes the group from the table.

         When the command is invoked with both a dgroup and a device
         specification, it adds the given device name (or names) to the group
         definition.  When invoked with both arguments and the -d option, the
         command deletes the device name (or names) from the group definition.

         When the command is invoked with both a dgroup and a device
         specification and the device group does not exist, it creates the
         group and adds the specified devices to that new group.

         The options and arguments for this command are:

         -d        Deletes the group or, if used with device, the device from
                   a group definition.

         dgroup    Specifies a device group name.

         device    Specifies the pathname or alias of the device that is to
                   added to or deleted from the device group.

   ERRORS
         The command will exit with one of the following values:

         0 = successful completion of the task.

         1 = command syntax incorrect, invalid option used, or internal error
             occurred.

         2 = device group table could not be opened for reading or a new
             device group table could not be created.

         3 = if executed with the -d option, indicates that an entry in the
             device group table for the device group dgroup does not exist and
             so cannot be deleted.  Otherwise, indicates that the device group
             dgroup already exists and cannot be added.


   8/91                                                                 Page 1

   putdgrp(1)                                                       putdgrp(1)


         4 = if executed with the -d option, indicates that the device group
             dgroup does not have as members one or more of the specified
             devices.  Otherwise, indicates that the device group dgroup
             already has one or more of the specified devices as members.

   EXAMPLE
         To add a new device group:
               putdgrp floppies
         To add a device to a device group:
               putdgrp floppies diskette2
         To delete a device group:
               putdgrp -d floppies
         To delete a device from a device group:
               putdgrp -d floppies diskette2

   FILES
         /etc/dgroup.tab

   SEE ALSO
         listdgrp(1), putdev(1M).

































   Page 2                                                                 8/91