DACS_GROUP(8) | DACS Web Services and CGI | DACS_GROUP(8)

## NAME

dacs_group — DACS group administration

## SYNOPSIS

`dacs_group` [`dacsoptions`]

## 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) web service.

### Web Service Arguments

Besides the standard CGI arguments, 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) 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), dacs.groups(5), regex(3)

## AUTHOR

Distributed Systems Software (www.dss.ca)

## COPYING

Copyright © 2003-2013 Distributed Systems Software. See the `LICENSE` file that accompanies the distribution for licensing information.

DACS Version 1.4.28b | 1-Mar-2013 | DACS_GROUP(8)

Table of Contents

Font:

- Z
- Z
- Z
- Z

−−

Set

++

$Id: dacs_group.8.xml 2625 2013-01-22 18:15:12Z brachman $