Skip to end of metadata
Go to start of metadata

PJSIP_ENDPOINT()

Synopsis

Get information about a PJSIP endpoint

Description

Syntax

PJSIP_ENDPOINT(name,field)
Arguments
  • name - The name of the endpoint to query.
  • field - The configuration option for the endpoint to query for. Supported options are those fields on the endpoint object in pjsip.conf.
    • 100rel - Allow support for RFC3262 provisional ACK tags
    • aggregate_mwi - Condense MWI notifications into a single NOTIFY.
    • allow - Media Codec(s) to allow
    • codec_prefs_incoming_offer - Codec negotiation prefs for incoming offers.
    • codec_prefs_outgoing_offer - Codec negotiation prefs for outgoing offers.
    • codec_prefs_incoming_answer - Codec negotiation prefs for incoming answers.
    • codec_prefs_outgoing_answer - Codec negotiation prefs for outgoing answers.
    • allow_overlap - Enable RFC3578 overlap dialing support.
    • overlap_context - Dialplan context to use for RFC3578 overlap dialing.
    • aors - AoR(s) to be used with the endpoint
    • auth - Authentication Object(s) associated with the endpoint
    • callerid - CallerID information for the endpoint
    • callerid_privacy - Default privacy level
    • callerid_tag - Internal id_tag for the endpoint
    • context - Dialplan context for inbound sessions
    • direct_media_glare_mitigation - Mitigation of direct media (re)INVITE glare
    • direct_media_method - Direct Media method type
    • trust_connected_line - Accept Connected Line updates from this endpoint
    • send_connected_line - Send Connected Line updates to this endpoint
    • connected_line_method - Connected line method type
    • direct_media - Determines whether media may flow directly between endpoints.
    • disable_direct_media_on_nat - Disable direct media session refreshes when NAT obstructs the media session
    • disallow - Media Codec(s) to disallow
    • dtmf_mode - DTMF mode
    • media_address - IP address used in SDP for media handling
    • bind_rtp_to_media_address - Bind the RTP instance to the media_address
    • force_rport - Force use of return port
    • ice_support - Enable the ICE mechanism to help traverse NAT
    • identify_by - Way(s) for the endpoint to be identified
    • redirect_method - How redirects received from an endpoint are handled
    • mailboxes - NOTIFY the endpoint when state changes for any of the specified mailboxes
    • mwi_subscribe_replaces_unsolicited - An MWI subscribe will replace sending unsolicited NOTIFYs
    • voicemail_extension - The voicemail extension to send in the NOTIFY Message-Account header
    • moh_suggest - Default Music On Hold class
    • outbound_auth - Authentication object(s) used for outbound requests
    • outbound_proxy - Full SIP URI of the outbound proxy used to send requests
    • rewrite_contact - Allow Contact header to be rewritten with the source IP address-port
    • rtp_ipv6 - Allow use of IPv6 for RTP traffic
    • rtp_symmetric - Enforce that RTP must be symmetric
    • send_diversion - Send the Diversion header, conveying the diversion information to the called user agent
    • send_history_info - Send the History-Info header, conveying the diversion information to the called and calling user agents
    • send_pai - Send the P-Asserted-Identity header
    • send_rpid - Send the Remote-Party-ID header
    • rpid_immediate - Immediately send connected line updates on unanswered incoming calls.
    • timers_min_se - Minimum session timers expiration period
    • timers - Session timers for SIP packets
    • timers_sess_expires - Maximum session timer expiration period
    • transport - Explicit transport configuration to use
    • trust_id_inbound - Accept identification information received from this endpoint
    • trust_id_outbound - Send private identification details to the endpoint.
    • type - Must be of type 'endpoint'.
    • use_ptime - Use Endpoint's requested packetization interval
    • use_avpf - Determines whether res_pjsip will use and enforce usage of AVPF for this endpoint.
    • force_avp - Determines whether res_pjsip will use and enforce usage of AVP, regardless of the RTP profile in use for this endpoint.
    • media_use_received_transport - Determines whether res_pjsip will use the media transport received in the offer SDP in the corresponding answer SDP.
    • media_encryption - Determines whether res_pjsip will use and enforce usage of media encryption for this endpoint.
    • media_encryption_optimistic - Determines whether encryption should be used if possible but does not terminate the session if not achieved.
    • g726_non_standard - Force g.726 to use AAL2 packing order when negotiating g.726 audio
    • inband_progress - Determines whether chan_pjsip will indicate ringing using inband progress.
    • call_group - The numeric pickup groups for a channel.
    • pickup_group - The numeric pickup groups that a channel can pickup.
    • named_call_group - The named pickup groups for a channel.
    • named_pickup_group - The named pickup groups that a channel can pickup.
    • device_state_busy_at - The number of in-use channels which will cause busy to be returned as device state
    • t38_udptl - Whether T.38 UDPTL support is enabled or not
    • t38_udptl_ec - T.38 UDPTL error correction method
    • t38_udptl_maxdatagram - T.38 UDPTL maximum datagram size
    • fax_detect - Whether CNG tone detection is enabled
    • fax_detect_timeout - How long into a call before fax_detect is disabled for the call
    • t38_udptl_nat - Whether NAT support is enabled on UDPTL sessions
    • t38_udptl_ipv6 - Whether IPv6 is used for UDPTL Sessions
    • t38_bind_udptl_to_media_address - Bind the UDPTL instance to the media_adress
    • tone_zone - Set which country's indications to use for channels created for this endpoint.
    • language - Set the default language to use for channels created for this endpoint.
    • one_touch_recording - Determines whether one-touch recording is allowed for this endpoint.
    • record_on_feature - The feature to enact when one-touch recording is turned on.
    • record_off_feature - The feature to enact when one-touch recording is turned off.
    • rtp_engine - Name of the RTP engine to use for channels created for this endpoint
    • allow_transfer - Determines whether SIP REFER transfers are allowed for this endpoint
    • user_eq_phone - Determines whether a user=phone parameter is placed into the request URI if the user is determined to be a phone number
    • moh_passthrough - Determines whether hold and unhold will be passed through using re-INVITEs with recvonly and sendrecv to the remote side
    • sdp_owner - String placed as the username portion of an SDP origin (o=) line.
    • sdp_session - String used for the SDP session (s=) line.
    • tos_audio - DSCP TOS bits for audio streams
    • tos_video - DSCP TOS bits for video streams
    • cos_audio - Priority for audio streams
    • cos_video - Priority for video streams
    • allow_subscribe - Determines if endpoint is allowed to initiate subscriptions with Asterisk.
    • sub_min_expiry - The minimum allowed expiry time for subscriptions initiated by the endpoint.
    • from_user - Username to use in From header for requests to this endpoint.
    • mwi_from_user - Username to use in From header for unsolicited MWI NOTIFYs to this endpoint.
    • from_domain - Domain to use in From header for requests to this endpoint.
    • dtls_verify - Verify that the provided peer certificate is valid
    • dtls_rekey - Interval at which to renegotiate the TLS session and rekey the SRTP session
    • dtls_auto_generate_cert - Whether or not to automatically generate an ephemeral X.509 certificate
    • dtls_cert_file - Path to certificate file to present to peer
    • dtls_private_key - Path to private key for certificate file
    • dtls_cipher - Cipher to use for DTLS negotiation
    • dtls_ca_file - Path to certificate authority certificate
    • dtls_ca_path - Path to a directory containing certificate authority certificates
    • dtls_setup - Whether we are willing to accept connections, connect to the other party, or both.
    • dtls_fingerprint - Type of hash to use for the DTLS fingerprint in the SDP.
    • srtp_tag_32 - Determines whether 32 byte tags should be used instead of 80 byte tags.
    • set_var - Variable set on a channel involving the endpoint.
    • message_context - Context to route incoming MESSAGE requests to.
    • accountcode - An accountcode to set automatically on any channels created for this endpoint.
    • preferred_codec_only - Respond to a SIP invite with the single most preferred codec (DEPRECATED)
    • incoming_call_offer_pref - Preferences for selecting codecs for an incoming call.
    • outgoing_call_offer_pref - Preferences for selecting codecs for an outgoing call.
    • rtp_keepalive - Number of seconds between RTP comfort noise keepalive packets.
    • rtp_timeout - Maximum number of seconds without receiving RTP (while off hold) before terminating call.
    • rtp_timeout_hold - Maximum number of seconds without receiving RTP (while on hold) before terminating call.
    • acl - List of IP ACL section names in acl.conf
    • deny - List of IP addresses to deny access from
    • permit - List of IP addresses to permit access from
    • contact_acl - List of Contact ACL section names in acl.conf
    • contact_deny - List of Contact header addresses to deny
    • contact_permit - List of Contact header addresses to permit
    • subscribe_context - Context for incoming MESSAGE requests.
    • contact_user - Force the user on the outgoing Contact header to this value.
    • asymmetric_rtp_codec - Allow the sending and receiving RTP codec to differ
    • rtcp_mux - Enable RFC 5761 RTCP multiplexing on the RTP port
    • refer_blind_progress - Whether to notifies all the progress details on blind transfer
    • notify_early_inuse_ringing - Whether to notifies dialog-info 'early' on InUse&Ringing state
    • max_audio_streams - The maximum number of allowed audio streams for the endpoint
    • max_video_streams - The maximum number of allowed video streams for the endpoint
    • bundle - Enable RTP bundling
    • webrtc - Defaults and enables some options that are relevant to WebRTC
    • incoming_mwi_mailbox - Mailbox name to use when incoming MWI NOTIFYs are received
    • follow_early_media_fork - Follow SDP forked media when To tag is different
    • accept_multiple_sdp_answers - Accept multiple SDP answers on non-100rel responses
    • suppress_q850_reason_headers - Suppress Q.850 Reason headers for this endpoint
    • ignore_183_without_sdp - Do not forward 183 when it doesn't contain SDP
    • stir_shaken - Enable STIR/SHAKEN support on this endpoint
    • stir_shaken_profile - STIR/SHAKEN profile containing additional configuration options
    • allow_unauthenticated_options - Skip authentication when receiving OPTIONS requests
    • security_negotiation - The kind of security agreement negotiation to use. Currently, only mediasec is supported.
    • security_mechanisms - List of security mechanisms supported.
    • geoloc_incoming_call_profile - Geolocation profile to apply to incoming calls
    • geoloc_outgoing_call_profile - Geolocation profile to apply to outgoing calls
    • send_aoc - Send Advice-of-Charge messages

See Also

Import Version

This documentation was imported from Asterisk Version GIT-18-ef6901e

  • No labels