putdgrp(1)            UNIX System V(Essential Utilities)             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.



10/89                                                                    Page 1

putdgrp(1)            UNIX System V(Essential Utilities)             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                                                                    10/89