/usr/include/sipxtapi/net/SipLine.h is in libsipxtapi-dev 3.3.0~test17-2.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 | //
// Copyright (C) 2004-2006 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2004-2006 Pingtel Corp. All rights reserved.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$
///////////////////////////////////////////////////////////////////////////////
#if !defined(AFX_SIPLINE_H__6AD8439B_AA8A_4F09_B5C4_44A3BA9C7AC6__INCLUDED_)
#define AFX_SIPLINE_H__6AD8439B_AA8A_4F09_B5C4_44A3BA9C7AC6__INCLUDED_
// SYSTEM INCLUDES
//#include <...>
// APPLICATION INCLUDES
#include <utl/UtlHashBag.h>
#include "HttpMessage.h"
#include "net/Url.h"
// DEFINES
// MACROS
// EXTERNAL FUNCTIONS
// EXTERNAL VARIABLES
// CONSTANTS
// STRUCTS
// TYPEDEFS
/**
* Line contact type: Use the local address or a NAT-derived address
* (e.g. STUN)
*/
typedef enum LINE_CONTACT_TYPE
{
LINE_CONTACT_LOCAL, /**< Use the local IP address */
LINE_CONTACT_NAT_MAPPED /**< Use the NAT-derived IP address */
} LINE_CONTACT_TYPE ;
//STATE TRANSITION//
/*
|----1/2refresh time--|
|--------------refresh time-------------|
--------- ------------ -------- ---------
| TRYING| ---------> |REGISTERED| --------->|FAILED| -------->|EXPIRED|
--------- ------------ -------- ---------
| | ^ ^
| |___| |
| |
|______________________failed the first time____________________|
*/
class SipLine
{
public:
//utility functions
enum LineStates
{
LINE_STATE_UNKNOWN = 0,
LINE_STATE_REGISTERED, //sucessfull registeration , registration no expried on server
LINE_STATE_DISABLED, //not registering
LINE_STATE_FAILED, //failed registration
LINE_STATE_PROVISIONED, //dont send registration , but enabled because server provisioned it.
LINE_STATE_TRYING, //registration message sent , awaiting response
LINE_STATE_EXPIRED //registration expried on server
};
SipLine(Url userEnteredUrl = "",
Url identityUri = "",
UtlString user ="",
UtlBoolean visible = TRUE,
int state = LINE_STATE_REGISTERED,
UtlBoolean isAutoEnabled = TRUE,
UtlBoolean useCallHandling = FALSE);
virtual ~SipLine();
SipLine(const SipLine& rSipLine);
SipLine& operator=(const SipLine& rSipLine);
UtlBoolean isDeviceLine() ;
//: Determine if this line is a device line. Presently, a line is
// considered a device line if it's user is "Device"
UtlBoolean IsDuplicateRealm(const UtlString realm , const UtlString scheme = HTTP_DIGEST_AUTHENTICATION);
UtlString& getLineId();
int getState() ;
void setState(int state) ;
//who does the line belong to
UtlString& getUser();
void setUser(const UtlString user);
//line identily or name - just the Uri
void getIdentityAndUrl(Url &identity, Url &userEnteredUrl) ;
void setIdentityAndUrl(Url identity, Url userEnteredUrl) ;
Url& getUserEnteredUrl() ;
Url& getIdentity() ;
Url& getCanonicalUrl() ;
//if line will get enabled after reboot - ( ie it is persitant)
void setAutoEnableStatus( UtlBoolean isAutoEnabled);
UtlBoolean getAutoEnableStatus();
//to use the call handling of the owner or not
UtlBoolean getCallHandling();
void setCallHandling( UtlBoolean useCallHandling = TRUE);
//if line is visible in the line list to the user
UtlBoolean getVisibility();
void setVisibility( UtlBoolean isEnable = TRUE);
//for use from GUI
int GetNumOfCredentials();
UtlBoolean addCredentials(const UtlString& strRealm,
const UtlString& strUserID,
const UtlString& strPassword,
const UtlString& Type);
UtlBoolean getCredentials(const UtlString& type /*[in]*/,
const UtlString& realm /*[in]*/,
UtlString* userID /*[out]*/,
UtlString* MD5_token /*[out]*/);
UtlBoolean getDuplicateCredentials(const UtlString& type /*[in]*/,
const UtlString& realm /*[in]*/);
UtlBoolean getAllCredentials( int MaxEnteries/*[in]*/ ,
int& actualEnteries /*[out/int]*/,
UtlString realms[]/*[out/int]*/,
UtlString UserId[]/*[out/int]*/,
UtlString type[]/*[out/int]*/,
UtlString passtoken[]/*[out/int]*/);
//removes credetials for a particular realm
UtlBoolean removeCredential(const UtlString* realm);
//removes all credentials for this line
void removeAllCredentials();
void setPreferredContactUri(const Url& preferredContactUri) ;
//: Set the preferred host/ip for the contact in subsequent registers
UtlBoolean getPreferredContactUri(Url& preferredContactUri) const ;
//: Get Preferred host/ip for the contact in subsequent registers
LINE_CONTACT_TYPE getContactType() const ;
void setContactType(LINE_CONTACT_TYPE eContactType) ;
protected:
UtlBoolean mIsVisible;
UtlBoolean mIsAutoEnabled;
UtlBoolean mIsUsingCallHandling;
Url mIdentity; //line key which is the canonical URL stripped of display name, angle brackets and field parameters (basically the URI).
Url mUserEnteredUrl; //user entered URL string (could be incomplete "sip:444@")
Url mCanonicalUrl; //The canonical URL which is the URL string with the host and port filled in if they were missing.
LINE_CONTACT_TYPE meContactType; /**< Type of of contact address (either LOCAL or NAT_MAPPED) */
UtlString mUser;
UtlString mLineId;
int mCurrentState;
Url mPreferredContactUri ;
UtlHashBag mCredentials;
void copyCredentials(const SipLine& rSipLine);
void generateLineID(UtlString& lineId);
};
#endif // !defined(AFX_SIPLINE_H__6AD8439B_AA8A_4F09_B5C4_44A3BA9C7AC6__INCLUDED_)
|