putdgrp(1)               USER COMMANDS                 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 specifi-
     cation, 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 inter-
         nal 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.

     4 = if executed with  the  -d  option,  indicates  that  the



                Last change: Essential Utilities                1

putdgrp(1)               USER COMMANDS                 putdgrp(1)



         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).































                Last change: Essential Utilities                2