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

NAME

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

Synopsis

16       sip-dig [OPTIONS] uri...
17

Description

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

Command Line Options

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

Return Codes

68       0when successful (a 2XX-series response is received) 1when unsuccessful
69       (a 3XX..6XX-series response is received) 2initialization failure
70

Examples

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

Environment

88       SRESOLV_DEBUG, SRESOLV_CONF
89

Reporting Bugs

91       Report bugs to <sofia-sip-devel@lists.sourceforge.net>.
92

Author

94       Written by Pekka Pessi <pekka -dot pessi -at- nokia -dot- com>
95

97       Copyright (C) 2006 Nokia Corporation.
98
99       This program is free software; see the source for copying conditions.
100       There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
101       PARTICULAR PURPOSE.
102
103
104
105Version 1.12.10                   8 Dec 2008                        sip-dig(1)
Impressum