File: condor_token_request_list.rst

package info (click to toggle)
condor 23.9.6%2Bdfsg-2.1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 60,012 kB
  • sloc: cpp: 528,272; perl: 87,066; python: 42,650; ansic: 29,558; sh: 11,271; javascript: 3,479; ada: 2,319; java: 619; makefile: 615; xml: 613; awk: 268; yacc: 78; fortran: 54; csh: 24
file content (87 lines) | stat: -rw-r--r-- 2,726 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87


*condor_token_request_list*
===========================

list all token requests at a remote daemon
:index:`condor_token_request_list<single: condor_token_request_list; HTCondor commands>`\ :index:`condor_token_request_list command`

Synopsis
--------

**condor_token_request_list**
[**-pool** *pool_name*] [**-name** hostname] [**-type** *type*] [**-json**]
[**-debug**]

**condor_token_request_list** [**-help** ]

Description
-----------

*condor_token_request_list* will list all requests for tokens currently
queued at a remote daemon.  This allows the administrator to review token requests;
these requests may be subsequently approved with an invocation of *condor_token_request_approve*.

An individual with ``ADMINISTRATOR`` authorization may see all queued token requests;
otherwise, users can only see token requests for their own identity.

By default, *condor_token_request_list* will query the local *condor_collector*;
by specifying a combination of **-pool**, **-name**, or **-type**, the tool can
request tokens in other pools, on other hosts, or different daemon types.

Options
-------

 **-debug**
    Causes debugging information to be sent to ``stderr``, based on the
    value of the configuration variable :macro:`TOOL_DEBUG`.
 **-help**
    Display brief usage information and exit.
 **-name** *hostname*
    Request a token from the daemon named *hostname* in the pool.  If not specified,
    the locally-running daemons will be used.
 **-pool** *pool_name*
    Request a token from a daemon in a non-default pool *pool_name*.
 **-json**
    Causes all pending requests to be printed as JSON objects.
 **-type** *type*
    Request a token from a specific daemon type *type*.  If not given, a
    *condor_collector* is used.

Examples
--------

To list the tokens at the default *condor_collector*:

.. code-block:: console

    $ condor_token_request_list
    RequestId = "4303687"
    ClientId = "worker0000.wisc.edu-960"
    PeerLocation = "10.0.4.13"
    AuthenticatedIdentity = "anonymous@ssl"
    RequestedIdentity = "condor@cs.wisc.edu"
    LimitAuthorization = "ADVERTISE_STARTD"

    RequestedIdentity = "bucky@cs.wisc.edu"
    AuthenticatedIdentity = "bucky@cs.wisc.edu"
    PeerLocation = "129.93.244.211"
    ClientId = "desktop0001.wisc.edu-712"
    RequestId = "4413973"

Exit Status
-----------

*condor_token_request_list* will exit with a non-zero status value if it
fails to communicate with the remote daemon or fails to authenticate.
Otherwise, it will exit 0.

See also
--------

:manpage:`condor_token_request(1)`, :manpage:`condor_token_request_approve(1)`, :manpage:`condor_token_list(1)`

Author
------

Center for High Throughput Computing, University of Wisconsin-Madison