dacslist

DACSLIST(1)                  DACS Commands Manual                  DACSLIST(1)



NAME
       dacslist - list jurisdictions

SYNOPSIS
       dacslist [dacsoptions[1]] [-f] [-j jurisdiction-name] [-k]

DESCRIPTION
       This program is part of the DACS suite.

       For a jurisdiction configured on the host where this program is run,
       the dacslist utility lists information about all known jurisdictions in
       the same federation. It can also display information about the
       federation.

       This program is also available as a DACS web service,
       dacs_list_jurisdictions(8)[2].

           Security
           Because this program may access the federation and jurisdiction key
           files (item types federation_keys and jurisdiction_keys,
           respectively), only the DACS administrator should be able to run
           this command.

OPTIONS
       The program respects the -format flag. Except for error messages,
       information is printed to the standard output.

       -f
           Only list information about the federation. Equivalent to -j "".

       -j jurisdiction-name
           Limit the output to the specified jurisdiction name. As a special
           case, if the argument is the empty string, only federation-scoped
           information will be returned.

       -k
           Only the federation's or a jurisdiction's public key (if known)
           will be displayed. If -j is given and is not the empty string, that
           jurisdiction name is selected; if -j is given and is the empty
           string, the federation is selected; and if the argument is absent,
           the current jurisdiction is selected. A PEM [RFC 1421[3], RFC
           1422[4], RFC 1423[5], RFC 1424[6]] formatted key is returned.

           Note
           In the current implementation, a jurisdiction's public key can only
           be provided by one of the jurisdictions configured on the same
           host.

EXAMPLES
       To list all jurisdictions in the same federation as jurisdiction J1,
       which must be configured on this host:

           % dacslist -uj J1

       To copy the public encryption key for J1 to pubkey:

           % dacslist -uj J1 -k > pubkey

       To display the public encryption key for J1's federation:

           % dacslist -uj J1 -f -k

       To retrieve the public encryption key for J1, which must be in the same
       federation as J2:

           % dacslist -uj J2 -k -j J1

       To display information about the federation to which jurisdiction J1
       belongs:

           % dacslist -uj J1 -f


DIAGNOSTICS
       The program exits 0 if everything was fine, 1 if an error occurred.
       Error messages are printed to stderr.

SEE ALSO
       dacs_list_jurisdictions(8)[2], dacs.groups(5)[7]

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

COPYING
       Copyright2003-2012 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_list_jurisdictions(8)
           http://dacs.dss.ca/man/dacs_list_jurisdictions.8.html

        3. RFC 1421
           http://www.rfc-editor.org/rfc/rfc1421.txt

        4. RFC 1422
           http://www.rfc-editor.org/rfc/rfc1422.txt

        5. RFC 1423
           http://www.rfc-editor.org/rfc/rfc1423.txt

        6. RFC 1424
           http://www.rfc-editor.org/rfc/rfc1424.txt

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

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

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



DACS 1.4.28b                      02/04/2014                       DACSLIST(1)