Provided by: dacs_1.4.28b-3ubuntu2_i386 bug


       dacs_list_jurisdictions - display information about DACS jurisdictions


       dacs_list_jurisdictions [dacsoptions[1]]


       This web service is part of the DACS suite.

       The dacs_list_jurisdictions web service displays information, relative
       to the jurisdiction that receives the request, about its federation and
       other jurisdictions in that federation. Included are the federation's
       public encryption key and its unique instance identifier.

       The FORMAT argument (see[2]) determines the type of
       output, with the default being HTML, using the style sheet
       dacs_list_jurisdictions.css[3]. The various flavours of XML, a PHP
       format (see below), JSON, and plain text (TEXT) are supported.

       One application of dacs_list_jurisdictions is to assist middleware to
       generate a menu of jurisdictions for user authentication. If FORMAT is
       PHP, a list of each jurisdiction that provides an authentication
       service is emitted (as text/plain, one jurisdiction per line. Each line
       has the format:


       The string jname is the DACS jurisdiction name and url is the complete
       URL prefix for DACS web services at the jurisdiction. For example,
       invoking this URL:


       might return the following response:


       The html/examples/login.php[4] template demonstrates this feature. If
       XML output is selected, a document conforming to
       dacs_list_jurisdictions.dtd[5] is returned.

       When returned as an XML attribute, a public encryption key is a base-64
       encoding of the PEM formatted key.

           This program is also available as a DACS utility, dacslist(1)[6].
           Because dacs_admin(8)[7] provides the same functionality and more,
           dacs_list_jurisdictions may be removed in a future release.

   Web Service Arguments
       In addition to the standard CGI arguments[8], dacs_list_jurisdictions
       understands the following CGI arguments:

           Limit the output to the specified jurisdiction name. As a special
           case, if the argument does not specify a jurisdiction name, only
           federation-scoped information will be returned.

           If this argument is "yes" (case insensitive) only the federation's
           or a jurisdiction's public key (if known) will be returned. If
           JURISDICTION is given and is not the empty string, that
           jurisdiction name is selected; if JURISDICTION is given and is the
           empty string, the federation is selected; and if the argument is
           absent, the current jurisdiction is selected. This argument
           currently requires FORMAT to be TEXT. A PEM [RFC 1421[9], RFC
           1422[10], RFC 1423[11], RFC 1424[12]] formatted key is returned.

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




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


       dacs(1)[13], dacskey(1)[14], dacslist(1)[6], dacs.groups(5)[15]


       Distributed Systems Software ([16])


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


        1. dacsoptions


        3. dacs_list_jurisdictions.css

        4. html/examples/login.php

        5. dacs_list_jurisdictions.dtd

        6. dacslist(1)

        7. dacs_admin(8)

        8. standard CGI arguments

        9. RFC 1421

       10. RFC 1422

       11. RFC 1423

       12. RFC 1424

       13. dacs(1)

       14. dacskey(1)

       15. dacs.groups(5)


       17. LICENSE