SYNOPSIS

dacs_group [\m[blue]dacsoptions\m[]\s-2\u[1]\d\s+2]

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 \m[blue]dacs_admin(8)\m[]\s-2\u[2]\d\s+2 web service.

Web Service Arguments

Besides the \m[blue]standard CGI arguments\m[]\s-2\u[3]\d\s+2, 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 (\m[blue]groups.dtd\m[]\s-2\u[4]\d\s+2) 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.

RELATED TO dacs_group…

\m[blue]dacs(1)\m[]\s-2\u[5]\d\s+2, \m[blue]dacs.groups(5)\m[]\s-2\u[6]\d\s+2, \m[blue]regex(3)\m[]\s-2\u[7]\d\s+2

AUTHOR

Distributed Systems Software (\m[blue]www.dss.ca\m[]\s-2\u[8]\d\s+2)

COPYING

Copyright2003-2013 Distributed Systems Software. See the \m[blue]LICENSE\m[]\s-2\u[9]\d\s+2 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+9.1-RELEASE&format=html

8.

www.dss.ca

http://www.dss.ca

9.

LICENSE

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