sip-dig(1) [debian man page]
sip-dig(1) sofia-sip-utils sip-dig(1) NAME
sip-dig - Resolve SIP URIs. This is an example program for sresolv library in synchronous mode. Author: Pekka Pessi <Pekka.Pessi@nokia.com> Date: Original Created: Tue Jul 16 18:50:14 2002 ppessi Synopsis sip-dig [OPTIONS] uri... Description The sip-dig utility resolves SIP URIs as described in RFC 3263. It queries NAPTR, SRV and A/AAAA records and prints out the resulting transport addresses. The default transports are: UDP, TCP, SCTP, TLS and TLS-SCTP. The SIPS URIs are resolved using only TLS transports, TLS and TLS-SCTP. If not otherwise indicated by NAPTR or SRV records, the sip-dig uses UDP and TCP as transports for SIP and TLS for SIPS URIs. The results are printed intended, with a preference followed by weight, then protocol name, port number and IP address in numeric format. Command Line Options The sip-dig utility accepts following command line options: -p protoname Use named transport protocol. The protoname can be either well-known, e.g., 'udp', or it can specify NAPTR service and SRV identifier, e.g., 'tls-udp/SIPS+D2U/_sips._udp.'. --udp Use UDP transport protocol. --tcp Use TCP transport protocol. --tls Use TLS over TCP transport protocol. --sctp Use SCTP transport protocol. --tls-sctp Use TLS over SCTP transport protocol. --no-sctp Ignore SCTP or TLS-SCTP records in the list of default transports. This option has no effect if transport protocols has been explicitly listed. -4 Query IP4 addresses (A records) -6 Query IP6 addresses (AAAA records). -v Be verbatim. Return Codes 0when successful (a 2XX-series response is received) 1when unsuccessful (a 3XX..6XX-series response is received) 2initialization failure Examples Resolve sip:openlaboratory.net, prefer TLS over TCP, TCP over UDP: $ sip-dig --tls --tcp --udp sip:openlaboratory.net 1 0.333 tls 5061 212.213.221.127 2 0.333 tcp 5060 212.213.221.127 3 0.333 udp 5060 212.213.221.127 Resolve sips:example.net with TLS over SCTP (TLS-SCTP) and TLS: $ sip-dig -p tls-sctp --tls sips:example.net 1 0.500 tls-udp 5061 172.21.55.26 2 0.500 tls 5061 172.21.55.26 Environment #SRESOLV_DEBUG, SRESOLV_CONF Reporting Bugs Report bugs to <sofia-sip-devel@lists.sourceforge.net>. Author Written by Pekka Pessi <pekka -dot pessi -at- nokia -dot- com> Copyright Copyright (C) 2006 Nokia Corporation. This program is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Version 1.12.11devel Sat May 7 2011 sip-dig(1)
Check Out this Related Man Page
eXosip2 configuration API(3) libeXosip2 eXosip2 configuration API(3) NAME
eXosip2 configuration API - Functions int eXosip_init (void) void eXosip_quit (void) int eXosip_execute (void) int eXosip_set_option (int opt, const void *value) int eXosip_lock (void) int eXosip_unlock (void) struct osip_naptr * eXosip_dnsutils_naptr (const char *domain, const char *protocol, const char *transport, int keep_in_cache) int eXosip_dnsutils_dns_process (struct osip_naptr *output_record, int force) int eXosip_dnsutils_rotate_srv (struct osip_srv_record *output_record) int eXosip_listen_addr (int transport, const char *addr, int port, int family, int secure) int eXosip_set_socket (int transport, int socket, int port) void eXosip_set_user_agent (const char *user_agent) const char * eXosip_get_version (void) int eXosip_set_cbsip_message (CbSipCallback cbsipCallback) void eXosip_enable_ipv6 (int ipv6_enable) void eXosip_masquerade_contact (const char *public_address, int port) int eXosip_find_free_port (int free_port, int transport) Detailed Description Function Documentation int eXosip_init (void) Initiate the eXtented oSIP library. void eXosip_quit (void) Release resource used by the eXtented oSIP library. int eXosip_execute (void) Process (non-threaded mode ONLY) eXosip events. int eXosip_set_option (intopt, const void *value) Set eXosip options. See eXosip_option for available options. Parameters: opt option to configure. value value for options. int eXosip_lock (void) Lock the eXtented oSIP library. int eXosip_unlock (void) UnLock the eXtented oSIP library. struct osip_naptr* eXosip_dnsutils_naptr (const char *domain, const char *protocol, const char *transport, intkeep_in_cache) [read] Start and return osip_naptr context. Note that DNS results might not yet be available. Parameters: domain domain name for NAPTR record protocol protocol to use ('SIP') transport transport to use ('UDP') keep_in_cache keep result in cache if >0 int eXosip_dnsutils_dns_process (struct osip_naptr *output_record, intforce) Continue to process asynchronous DNS request (if implemented). Parameters: output_record result structure. force force waiting for final answer if >0 int eXosip_dnsutils_rotate_srv (struct osip_srv_record *output_record) Rotate first SRV entry to last SRV entry. Parameters: output_record result structure. int eXosip_listen_addr (inttransport, const char *addr, intport, intfamily, intsecure) Listen on a specified socket. Parameters: transport IPPROTO_UDP for udp. (soon to come: TCP/TLS?) addr the address to bind (NULL for all interface) port the listening port. (0 for random port) family the IP family (AF_INET or AF_INET6). secure 0 for UDP or TCP, 1 for TLS (with TCP). int eXosip_set_socket (inttransport, intsocket, intport) Listen on a specified socket. Parameters: transport IPPROTO_UDP for udp. (soon to come: TCP/TLS?) socket socket to use for listening to UDP sip messages. port the listening port for masquerading. void eXosip_set_user_agent (const char *user_agent) Set the SIP User-Agent: header string. Parameters: user_agent the User-Agent header to insert in messages. const char* eXosip_get_version (void) Get the eXosip version as a sring int eXosip_set_cbsip_message (CbSipCallbackcbsipCallback) Set a callback to get sent and received SIP messages. Parameters: cbsipCallback the callback to retreive messages. void eXosip_enable_ipv6 (intipv6_enable) Use IPv6 instead of IPv4. Parameters: ipv6_enable This parameter should be set to 1 to enable IPv6 mode. void eXosip_masquerade_contact (const char *public_address, intport) This method is used to replace contact address with the public address of your NAT. The ip address should be retreived manually (fixed IP address) or with STUN. This address will only be used when the remote correspondant appears to be on an DIFFERENT LAN. Parameters: public_address the ip address. port the port for masquerading. If set to NULL, then the local ip address will be guessed automatically (returns to default mode). int eXosip_find_free_port (intfree_port, inttransport) This method is used to find out an free IPPROTO_UDP or IPPROTO_TCP port. Parameters: free_port initial port for search. transport IPPROTO_UDP or IPPROTO_TCP protocol. Author Generated automatically by Doxygen for libeXosip2 from the source code. Version 3.1.0 Sun Jun 24 2012 eXosip2 configuration API(3)