nischgrp(1)                                                     nischgrp(1)




 NAME    [Toc]    [Back]
      nischgrp - change the group owner of an NIS+ object

 SYNOPSIS    [Toc]    [Back]
      nischgrp [ -AfLP ] group name...

 DESCRIPTION    [Toc]    [Back]
      nischgrp changes the group owner of the NIS+ objects or entries
      specified by name to the specified NIS+ group.  Entries are specified
      using indexed names (see nismatch(1)).  If group is not a fully
      qualified NIS+ group name, it will be resolved using the directory
      search path (see nisdefaults(1)).

      The only restriction on changing an object's group owner is that you
      must have modify permissions for the object.

      This command will fail if the master NIS+ server is not running.

    Options    [Toc]    [Back]
      -A   Modify all entries in all tables in the concatenation path that
           match the search criterion specified in name.  This option
           implies the -P switch.

      -f   Force the operation and fail silently if it does not succeed.

      -L   Follow links and change the group owner of the linked object or
           entries rather than the group owner of the link itself.

      -P   Follow the concatenation path within a named table.  This option
           only makes sense when either name is an indexed name or the -L
           switch is also specified and the named object is a link pointing
           to entries.

    Notes    [Toc]    [Back]
      The NIS+ server will check the validity of the group name prior to
      effecting the modification.

 EXAMPLES    [Toc]    [Back]
      Change the group owner of an object to a group in a different domain,
      and how to change it to a group in the local domain, respectively:

           nischgrp  newgroup.remote.domain.  object
           nischgrp  my-buds  object

      Change the group owner for a password entry:

           nischgrp  admins  '[uid=99],passwd.org_dir'

      In the above example, admins is an NIS+ group in the same domain.





 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 nischgrp(1)                                                     nischgrp(1)




      Change the group owner of the object or entries pointed to by a link,
      and the group owner of all entries in the hobbies table:

           nischgrp  -L  my-buds  linkname
           nischgrp  my-buds  '[],hobbies'

 EXTERNAL INFLUENCES    [Toc]    [Back]
    Environment Variables
      NIS_PATH       If this variable is set and the NIS+ name is not fully
                     qualified, each directory specified will be searched
                     until the object is found (see nisdefaults(1)).

 RETURN VALUE    [Toc]    [Back]
      nischgrp returns 0 on success and 1 on failure.

 WARNINGS    [Toc]    [Back]
      HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is
      supported.

      LDAP is the recommended replacement for NIS+.  HP fully supports the
      industry standard naming services based on LDAP.

 AUTHOR    [Toc]    [Back]
      nischgrp was developed by Sun Microsystems, Inc.

 SEE ALSO    [Toc]    [Back]
      nis+(1), nischmod(1), nischown(1), nisdefaults(1), nisgrpadm(1),
      nis_objects(3N).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003