1sip-dig(1)                      sofia-sip-utils                     sip-dig(1)
2
3
4

NAME

6       sip-dig - .TH "sip-dig" 1 "Fri Mar 11 2011" "Version 1.12.11" "sofia-
7       sip-utils"
8

NAME

10       sip-dig - This is an example program for sresolv library in synchronous
11       mode.
12
13       Author:
14           Pekka Pessi <Pekka.Pessi@nokia.com>
15
16       Date:
17           Original Created: Tue Jul 16 18:50:14 2002 ppessi
18

Synopsis

20       sip-dig [OPTIONS] uri...
21

Description

23       The sip-dig utility resolves SIP URIs as described in RFC 3263. It
24       queries NAPTR, SRV and A/AAAA records and prints out the resulting
25       transport addresses.
26
27       The default transports are: UDP, TCP, SCTP, TLS and TLS-SCTP. The SIPS
28       URIs are resolved using only TLS transports, TLS and TLS-SCTP. If not
29       otherwise indicated by NAPTR or SRV records, the sip-dig uses UDP and
30       TCP as transports for SIP and TLS for SIPS URIs.
31
32       The results are printed intended, with a preference followed by weight,
33       then protocol name, port number and IP address in numeric format.
34

Command Line Options

36       The sip-dig utility accepts following command line options:
37
38       -p protoname
39           Use named transport protocol. The protoname can be either well-
40           known, e.g., 'udp', or it can specify NAPTR service and SRV
41           identifier, e.g., 'tls-udp/SIPS+D2U/_sips._udp.'.
42
43       --udp
44           Use UDP transport protocol.
45
46       --tcp
47           Use TCP transport protocol.
48
49       --tls
50           Use TLS over TCP transport protocol.
51
52       --sctp
53           Use SCTP transport protocol.
54
55       --tls-sctp
56           Use TLS over SCTP transport protocol.
57
58       --no-sctp
59           Ignore SCTP or TLS-SCTP records in the list of default transports.
60           This option has no effect if transport protocols has been
61           explicitly listed.
62
63       -4  Query IP4 addresses (A records)
64
65       -6  Query IP6 addresses (AAAA records).
66
67       -v  Be verbatim.
68
69
70

Return Codes

72       0when successful (a 2XX-series response is received) 1when unsuccessful
73       (a 3XX..6XX-series response is received) 2initialization failure
74

Examples

76       Resolve sip:openlaboratory.net, prefer TLS over TCP, TCP over UDP:
77
78        $ sip-dig --tls --tcp --udp sip:openlaboratory.net
79               1 0.333 tls 5061 212.213.221.127
80               2 0.333 tcp 5060 212.213.221.127
81               3 0.333 udp 5060 212.213.221.127
82
83
84       Resolve sips:example.net with TLS over SCTP (TLS-SCTP) and TLS:
85
86        $ sip-dig -p tls-sctp --tls sips:example.net
87               1 0.500 tls-udp 5061 172.21.55.26
88               2 0.500 tls 5061 172.21.55.26
89
90

Environment

92       SRESOLV_DEBUG, SRESOLV_CONF
93

Reporting Bugs

95       Report bugs to <sofia-sip-devel@lists.sourceforge.net>.
96

Author

98       Written by Pekka Pessi <pekka -dot pessi -at- nokia -dot- com>
99
101       Copyright (C) 2006 Nokia Corporation.
102
103       This program is free software; see the source for copying conditions.
104       There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
105       PARTICULAR PURPOSE.
106
107
108
109Version 1.12.11                 Fri Mar 11 2011                     sip-dig(1)
Impressum