table of contents
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
-j jurisdiction-name
-k
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¶
Copyright © 2003-2012 Distributed Systems Software. See the LICENSE[9] file that accompanies the distribution for licensing information.
NOTES¶
- 1.
- dacsoptions
- 2.
- dacs_list_jurisdictions(8)
- 3.
- RFC 1421
- 4.
- RFC 1422
- 5.
- RFC 1423
- 6.
- RFC 1424
- 7.
- dacs.groups(5)
- 8.
- www.dss.ca
- 9.
- LICENSE
08/23/2020 | DACS 1.4.40 |