sip_domain

Manage sip domain names

Format

• [-v] [-V] -e [--local-domain-name s] [--remote-domain-name s]
• [-v] [-V] -i [--local-domain-name s] [--remote-domain-name s]
• [-v] [-V] -p

Function

The command is used to erase, initiate, and print sip domains.

Local domain names

Domain shall match the domain in an inbound REQUEST URI.

Remote domain names

An incoming call from a remote domain is treated as if a local SIP extension had made the call. It is possible to have numbers matching on the domains, so that only a specified number series is allowed. As an example, a remote domain could be a domain where extensions can have a dual registration.

Parameters

• -e, --erase

  Erase some settings; that is, deconfigure an item (or several items).

  The switch takes no arguments.

• -i, --initiate

  Initiate some settings; that is, make initial configuration of an item or several items).

  The switch takes no arguments.

• --local-domain-name

  Domain name to be added or removed to the set of local domains. Domain shall match the domain in an inbound REQUEST URI.

  Accepted argument length is 1 to 253 characters.

  The switch requires an argument. The argument can be a comma-separated sequence.

• -p, --print

  Print all or some settings; that is, print configuration of an item, several items, or all items.

  The switch takes no arguments.

• --remote-domain-name

  Domain name to be added to or removed from the set of remote domains. Domain shall match the domain in an inbound INVITE {from:<extension number>@<domain>}. Optional number matching is possible using the format [email protected].

  If a calling number from domain example.com starts with xyz the rest of the number, that matches the question mark, is treated as an internal number.

  Accepted argument length is 1 to 253 characters.

  The switch requires an argument. The argument can be a comma-separated sequence.

• -v, --verbose

  Turn on verbose output, that is, progress information, to standard error.

  The switch takes no arguments.

• -V, --verbose-to-syslog

  Turn on verbose logging to syslog (usually to /var/log/messages).

  The switch takes no arguments.

Examples

• Add local domain name ‘example.com’

  sip_domain -i --local-domain-name example.com

• Add remote domain name ‘extra.com’.

  sip_domain -i --remote-domain-name extra.com

• Add local domain name 'internal.com’ and remote domain name ‘external.com'.

  sip_domain -i --local-domain-name internal.com --remote-domain-name external.com

• Remove local domain name 'example.com'.

  sip_domain -e --local-domain-name example.com

• Remove remote domain name 'extra.com'.

  sip_domain -e --remote-domain-name extra.com

• Remove local domain name 'internal.com' and remote domain name 'external.com'.

  sip_domain -e --local-domain-name internal.com --remote-domain-name external.com

• All sip domains shall be erased.

  sip_domain -e

• Print all sip domains.

  sip_domain -p