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
|
[comment {-*- Tcl -*- doctools manpage}]
[manpage_begin ident n 0.42]
[copyright {2004 Reinhard Max <max@tclers.tk>}]
[titledesc {Ident protocol client}]
[moddesc {Identification protocol client}]
[require Tcl 8.3]
[require ident [opt 0.42]]
[description]
The [package ident] package provides a client implementation of the ident
protocol as defined in
RFC 1413 ([uri http://www.rfc-editor.org/rfc/rfc1413.txt]).
[list_begin definitions]
[call [cmd ::ident::query] [arg socket] [opt [arg callback]]]
This command queries the ident daemon on the remote side of the given
socket, and returns the result of the query as a dictionary.
Interpreting the dictionary as list the first key will always be
[const resp-type], and can have one of the values [const USERID],
[const ERROR], and [const FATAL]. These [term {response types}] have
the following meanings:
[list_begin definitions]
[def USERID]
This indicates a successful response. Two more keys and associated
values are returned, [const opsys], and [const user-id].
[def ERROR]
This means the ident server has returned an error. A second key named
[const error] is present whose value contains the [const error-type]
field from the server response.
[def FATAL]
Fatal errors happen when no ident server is listening on the remote
side, or when the ident server gives a response that does not conform
to the RFC. A detailed error message is returned under the
[const error] key.
[list_end]
[list_end]
[section {BUGS, IDEAS, FEEDBACK}]
This document, and the package it describes, will undoubtedly contain
bugs and other problems.
Please report such in the category [emph ident] of the
[uri {http://sourceforge.net/tracker/?group_id=12883} {Tcllib SF Trackers}].
Please also report any ideas for enhancements you may have for either
package and/or documentation.
[keywords {rfc 1413} ident identification]
[manpage_end]
|
