NAME

       dacs_group - DACS group administration

SYNOPSIS

       dacs_group [dacsoptions[1]]

DESCRIPTION

       This web service is part of the DACS suite.

       The dacs_group web service displays DACS group definitions and membership and performs
       administrative functions on them.

           Note
           This web service may eventually be replaced by the dacs_admin(8)[2] web service.

   Web Service Arguments
       Besides the standard CGI arguments[3], dacs_group understands the following CGI arguments:

       OPERATION
           This argument is required and selects one of the following functions. Additional
           arguments, if any, are function-dependent.

           •   SHOW_GROUP_MEMBERSHIP

               Arguments: GROUP_NAME, JURISDICTION (optional)

           •   LIST_GROUPS

               Arguments: JURISDICTION

           •   SHOW_GROUP_DEFINITION

               Arguments: GROUP_NAME, JURISDICTION (optional)

           •   SHOW_ROLES

               Display the roles associated with the caller.

           •   TEST_GROUP_MEMBERSHIP

               Test whether the caller is in the group specified by GROUP.

           •   LIST_GROUP_MEMBERSHIP

               Show which groups user MEMBER_NAME belongs to, as known by the receiving
               jurisdiction.  MATCH_JURISDICTION (optional) can be set to limit testing to those
               groups defined by the given jurisdiction.  MATCH_GROUP_NAME (optional) can be set
               to a regular expressions, applied to each known group name from any jurisdiction,
               to limit testing to those groups that match the given regex.

           •   CREATE_GROUP

               Arguments: GROUP_NAME, GROUP_TYPE

           •   DELETE_GROUP

               Arguments: GROUP_NAME, MEMBER_NAME

           •   ADD_GROUP_MEMBER

               Arguments: GROUP_NAME, MEMBER_NAME, MEMBER_TYPE, DACS

           •   DELETE_GROUP_MEMBER

               Arguments: GROUP_NAME, MEMBER_NAME

           •   PURGE_GROUP

               Delete the specified cached group definition.  JURISDICTION, GROUP_NAME

           •   CHANGE_GROUP_DEFINITION

               Arguments: GROUP_NAME, NEW_GROUP_NAME

           •   RECEIVE_GROUP_DEFINITION

               The jurisdiction receiving the request is being asked to cache one or more group
               definitions, passed as a groups element (groups.dtd[4]) that is the value of
               GROUPS.

           •   SEND_GROUP_DEFINITION

               Reply with one or more group definitions (master or cached copies).
               GROUP_NAME_LIST is a comma-separated list of group names.

           •   APPLY_DELTAS

DIAGNOSTICS

       The program exits 0 if everything was fine, 1 if an error occurred.

SEE ALSO

       dacs(1)[5], dacs.groups(5)[6], regex(3)[7]

AUTHOR

       Distributed Systems Software (www.dss.ca[8])

COPYING

       Copyright2003-2014 Distributed Systems Software. See the LICENSE[9] file that accompanies
       the distribution for licensing information.

NOTES

        1. dacsoptions
           http://dacs.dss.ca/man/dacs.1.html#dacsoptions

        2. dacs_admin(8)
           http://dacs.dss.ca/man/dacs_admin.8.html

        3. standard CGI arguments
           http://dacs.dss.ca/man/dacs.services.8.html#standard_cgi_args

        4. groups.dtd
           http://dacs.dss.ca/man/../dtd-xsd/groups.dtd

        5. dacs(1)
           http://dacs.dss.ca/man/dacs.1.html

        6. dacs.groups(5)
           http://dacs.dss.ca/man/dacs.groups.5.html

        7. regex(3)
           http://www.freebsd.org/cgi/man.cgi?query=regex&apropos=0&sektion=3&manpath=FreeBSD+10.1-RELEASE&format=html

        8. www.dss.ca
           http://www.dss.ca

        9. LICENSE
           http://dacs.dss.ca/man/../misc/LICENSE