All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
StatusCodeSvc Class Reference

#include <src/StatusCodeSvc.h>

Inheritance diagram for StatusCodeSvc:
Collaboration diagram for StatusCodeSvc:

Classes

struct  StatCodeDat
 

Public Member Functions

virtual StatusCode initialize ()
 Initialization (from CONFIGURED to INITIALIZED). More...
 
virtual StatusCode reinitialize ()
 Initialization (from INITIALIZED or RUNNING to INITIALIZED, via CONFIGURED). More...
 
virtual StatusCode finalize ()
 Finalize (from INITIALIZED to CONFIGURED). More...
 
virtual void regFnc (const std::string &func, const std::string &lib)
 
virtual void list () const
 
virtual bool suppressCheck () const
 
 StatusCodeSvc (const std::string &name, ISvcLocator *svc)
 
virtual ~StatusCodeSvc ()
 
- Public Member Functions inherited from extends1< Service, IStatusCodeSvc >
 extends1 (A1 a1, A2 a2, A3 a3)
 Templated constructor with 3 arguments. More...
 
 extends1 (A1 a1, A2 a2)
 Templated constructor with 2 arguments. More...
 
 extends1 (A1 a1)
 Templated constructor with 1 argument. More...
 
 extends1 ()
 Default constructor. More...
 
virtual void * i_cast (const InterfaceID &tid) const
 Implementation of IInterface::i_cast. More...
 
virtual StatusCode queryInterface (const InterfaceID &ti, void **pp)
 Implementation of IInterface::queryInterface. More...
 
virtual std::vector< std::string > getInterfaceNames () const
 Implementation of IInterface::getInterfaceNames. More...
 
virtual ~extends1 ()
 Virtual destructor. More...
 
- Public Member Functions inherited from Service
virtual unsigned long release ()
 Release Interface instance. More...
 
virtual const std::string & name () const
 Retrieve name of the service. More...
 
virtual StatusCode configure ()
 Configuration (from OFFLINE to CONFIGURED). More...
 
virtual StatusCode start ()
 Start (from INITIALIZED to RUNNING). More...
 
virtual StatusCode stop ()
 Stop (from RUNNING to INITIALIZED). More...
 
virtual StatusCode terminate ()
 Initialization (from CONFIGURED to OFFLINE). More...
 
virtual Gaudi::StateMachine::State FSMState () const
 Get the current state. More...
 
virtual Gaudi::StateMachine::State targetFSMState () const
 When we are in the middle of a transition, get the state where the transition is leading us. More...
 
virtual StatusCode restart ()
 Initialization (from RUNNING to RUNNING, via INITIALIZED). More...
 
virtual StatusCode sysInitialize ()
 Initialize Service. More...
 
virtual StatusCode sysStart ()
 Initialize Service. More...
 
virtual StatusCode sysStop ()
 Initialize Service. More...
 
virtual StatusCode sysFinalize ()
 Finalize Service. More...
 
virtual StatusCode sysReinitialize ()
 Re-initialize the Service. More...
 
virtual StatusCode sysRestart ()
 Re-initialize the Service. More...
 
virtual StatusCode setProperty (const Property &p)
 Set the property by property. More...
 
virtual StatusCode setProperty (const std::string &s)
 Set the property by string. More...
 
virtual StatusCode setProperty (const std::string &n, const std::string &v)
 Set the property by std::string. More...
 
virtual StatusCode getProperty (Property *p) const
 Get the property by property. More...
 
virtual const PropertygetProperty (const std::string &name) const
 Get the property by name. More...
 
virtual StatusCode getProperty (const std::string &n, std::string &v) const
 Get the property by std::string. More...
 
virtual const std::vector
< Property * > & 
getProperties () const
 Get list of properties. More...
 
template<class TYPE >
StatusCode setProperty (const std::string &name, const TYPE &value)
 set the property form the value More...
 
 Service (const std::string &name, ISvcLocator *svcloc)
 Standard Constructor. More...
 
SmartIF< ISvcLocator > & serviceLocator () const
 Retrieve pointer to service locator. More...
 
StatusCode setProperties ()
 Method for setting declared properties to the values specified for the job. More...
 
template<class T >
StatusCode service (const std::string &name, const T *&psvc, bool createIf=true) const
 Access a service by name, creating it if it doesn't already exist. More...
 
template<class T >
StatusCode service (const std::string &name, T *&psvc, bool createIf=true) const
 
template<class T >
StatusCode service (const std::string &svcType, const std::string &svcName, T *&psvc) const
 Access a service by name and type, creating it if it doesn't already exist. More...
 
template<class T >
PropertydeclareProperty (const std::string &name, T &property, const std::string &doc="none") const
 Declare the named property. More...
 
PropertydeclareRemoteProperty (const std::string &name, IProperty *rsvc, const std::string &rname="") const
 Declare remote named properties. More...
 
SmartIF< IAuditorSvc > & auditorSvc () const
 The standard auditor service.May not be invoked before sysInitialize() has been invoked. More...
 
- Public Member Functions inherited from CommonMessaging< implements3< IService, IProperty, IStateful > >
 CommonMessaging (const A1 &a1, const A2 &a2, const A3 &a3)
 Templated constructor with 3 arguments. More...
 
 CommonMessaging (const A1 &a1, const A2 &a2)
 Templated constructor with 2 arguments. More...
 
 CommonMessaging (const A1 &a1)
 Templated constructor with 1 argument. More...
 
 CommonMessaging ()
 Default constructor. More...
 
virtual ~CommonMessaging ()
 Virtual destructor. More...
 
SmartIF< IMessageSvc > & msgSvc () const
 The standard message service. More...
 
MsgStreammsgStream () const
 Return an uninitialized MsgStream. More...
 
MsgStreammsgStream (const MSG::Level level) const
 Predefined configurable message stream for the efficient printouts. More...
 
MsgStreamalways () const
 shortcut for the method msgStream(MSG::ALWAYS) More...
 
MsgStreamfatal () const
 shortcut for the method msgStream(MSG::FATAL) More...
 
MsgStreamerr () const
 shortcut for the method msgStream(MSG::ERROR) More...
 
MsgStreamerror () const
 shortcut for the method msgStream(MSG::ERROR) More...
 
MsgStreamwarning () const
 shortcut for the method msgStream(MSG::WARNING) More...
 
MsgStreaminfo () const
 shortcut for the method msgStream(MSG::INFO) More...
 
MsgStreamdebug () const
 shortcut for the method msgStream(MSG::DEBUG) More...
 
MsgStreamverbose () const
 shortcut for the method msgStream(MSG::VERBOSE) More...
 
MsgStreammsg () const
 shortcut for the method msgStream(MSG::INFO) More...
 
MSG::Level msgLevel () const
 get the output level from the embedded MsgStream More...
 
bool msgLevel (MSG::Level lvl) const
 get the output level from the embedded MsgStream More...
 
- Public Member Functions inherited from extend_interfaces3< IService, IProperty, IStateful >
virtual ~extend_interfaces3 ()
 Virtual destructor. More...
 
- Public Member Functions inherited from IService
 DeclareInterfaceID (IService, 3, 0)
 InterfaceID. More...
 
virtual ~IService ()
 virtual destructor More...
 
- Public Member Functions inherited from INamedInterface
 DeclareInterfaceID (INamedInterface, 1, 0)
 InterfaceID. More...
 
virtual ~INamedInterface ()
 Virtual destructor (always needed for abstract classes). More...
 
- Public Member Functions inherited from IInterface
virtual unsigned long addRef ()=0
 Increment the reference count of Interface instance. More...
 
virtual unsigned long refCount () const =0
 Current reference count. More...
 
virtual ~IInterface ()
 Virtual destructor. More...
 
- Public Member Functions inherited from IProperty
 DeclareInterfaceID (IProperty, 2, 0)
 InterfaceID. More...
 
- Public Member Functions inherited from IStateful
 DeclareInterfaceID (IStateful, 1, 0)
 InterfaceID. More...
 
virtual ~IStateful ()
 
- Public Member Functions inherited from extend_interfaces1< IStatusCodeSvc >
virtual ~extend_interfaces1 ()
 Virtual destructor. More...
 
- Public Member Functions inherited from IStatusCodeSvc
 DeclareInterfaceID (IStatusCodeSvc, 2, 0)
 InterfaceID. More...
 
virtual ~IStatusCodeSvc ()
 virtual destructor More...
 

Private Member Functions

void parseFilter (const std::string &str, std::string &fnc, std::string &lib)
 
void filterFnc (const std::string &)
 
void filterLib (const std::string &)
 

Private Attributes

StringArrayProperty m_pFilter
 
BooleanProperty m_abort
 
BooleanProperty m_suppress
 
BooleanProperty m_dict
 
std::map< std::string,
StatCodeDat
m_dat
 
std::set< std::string > m_filterfnc
 
std::set< std::string > m_filterlib
 

Additional Inherited Members

- Public Types inherited from extends1< Service, IStatusCodeSvc >
typedef extends1 base_class
 Typedef to this class. More...
 
typedef extend_interfaces1
< IStatusCodeSvc
extend_interfaces_base
 Typedef to the base of this class. More...
 
typedef
extend_interfaces_base::ext_iids 
interfaces
 MPL set of all the implemented interfaces. More...
 
- Public Types inherited from Service
typedef
Gaudi::PluginService::Factory
< IService *, const
std::string &, ISvcLocator * > 
Factory
 
- Public Types inherited from CommonMessaging< implements3< IService, IProperty, IStateful > >
typedef CommonMessaging base_class
 
- Public Types inherited from implements3< IService, IProperty, IStateful >
typedef implements3 base_class
 Typedef to this class. More...
 
typedef extend_interfaces3
< IService, IProperty,
IStateful
extend_interfaces_base
 Typedef to the base of this class. More...
 
typedef
extend_interfaces_base::ext_iids 
interfaces
 MPL set of all the implemented interfaces. More...
 
- Public Types inherited from extend_interfaces3< IService, IProperty, IStateful >
typedef mpl::fold< typename
IService::iid::iids::type,
typename mpl::fold< typename
IProperty::iid::iids::type,
typename
IStateful::iid::iids::type,
mpl::insert< mpl::_1, mpl::_2 >
>::type, mpl::insert< mpl::_1,
mpl::_2 > >::type 
ext_iids
 MPL set of interfaces extended by this one. More...
 
- Public Types inherited from IInterface
enum  Status { SUCCESS = 1, NO_INTERFACE, VERSMISMATCH, LAST_ERROR }
 Return status. More...
 
typedef Gaudi::InterfaceId
< IInterface, 0, 0 > 
iid
 Interface ID. More...
 
typedef mpl::set1< iidext_iids
 Extra interfaces. More...
 
- Public Types inherited from extend_interfaces1< IStatusCodeSvc >
typedef
IStatusCodeSvc::iid::iids::type 
ext_iids
 MPL set of interfaces extended by this one. More...
 
- Static Public Member Functions inherited from IInterface
static const InterfaceIDinterfaceID ()
 Return an instance of InterfaceID identifying the interface. More...
 
- Protected Member Functions inherited from Service
virtual ~Service ()
 Standard Destructor. More...
 
int outputLevel () const
 get the Service's output level More...
 
- Protected Member Functions inherited from CommonMessaging< implements3< IService, IProperty, IStateful > >
void updateMsgStreamOutputLevel (int level)
 Update the output level of the cached MsgStream. More...
 
- Protected Attributes inherited from Service
IntegerProperty m_outputLevel
 Service output level. More...
 
Gaudi::StateMachine::State m_state
 Service state. More...
 
Gaudi::StateMachine::State m_targetState
 Service state. More...
 
- Protected Attributes inherited from CommonMessaging< implements3< IService, IProperty, IStateful > >
SmartIF< IMessageSvcm_msgsvc
 Pointer to the message service;. More...
 
std::auto_ptr< MsgStreamm_msgStream
 The predefined message stream. More...
 
bool m_streamWithService
 Flag to create a new MsgStream if it was created without the message service. More...
 

Detailed Description

Definition at line 12 of file StatusCodeSvc.h.

Constructor & Destructor Documentation

StatusCodeSvc::StatusCodeSvc ( const std::string &  name,
ISvcLocator svc 
)

Definition at line 17 of file StatusCodeSvc.cpp.

18  : base_class( name, svc )
19 {
20 
21  declareProperty("Filter",m_pFilter);
22  declareProperty("AbortOnError",m_abort=false);
23  declareProperty("SuppressCheck", m_suppress=false);
24  declareProperty("IgnoreDicts",m_dict=true);
25 
26 }
BooleanProperty m_abort
Definition: StatusCodeSvc.h:42
BooleanProperty m_dict
Definition: StatusCodeSvc.h:42
BooleanProperty m_suppress
Definition: StatusCodeSvc.h:42
extends1 base_class
Typedef to this class.
Definition: extends.h:12
virtual const std::string & name() const
Retrieve name of the service.
Definition: Service.cpp:331
StringArrayProperty m_pFilter
Definition: StatusCodeSvc.h:41
Property * declareProperty(const std::string &name, T &property, const std::string &doc="none") const
Declare the named property.
Definition: Service.h:211
StatusCodeSvc::~StatusCodeSvc ( )
virtual

Definition at line 30 of file StatusCodeSvc.cpp.

30  {
31 
32 }

Member Function Documentation

void StatusCodeSvc::filterFnc ( const std::string &  str)
private

Definition at line 199 of file StatusCodeSvc.cpp.

199  {
200 
201  std::map<std::string, StatCodeDat>::iterator itr;
202  for (itr = m_dat.begin(); itr != m_dat.end(); ++itr ) {
203  if (itr->second.fnc == str) {
204  m_dat.erase(itr);
205  return;
206  }
207 
208  }
209 
210 }
std::map< std::string, StatCodeDat > m_dat
Definition: StatusCodeSvc.h:44
void StatusCodeSvc::filterLib ( const std::string &  str)
private

Definition at line 214 of file StatusCodeSvc.cpp.

214  {
215 
216  std::map<std::string, StatCodeDat>::iterator itr;
217  for (itr = m_dat.begin(); itr != m_dat.end(); ++itr ) {
218  if (itr->second.lib == str) {
219  m_dat.erase(itr);
220  return;
221  }
222 
223  }
224 
225 }
std::map< std::string, StatCodeDat > m_dat
Definition: StatusCodeSvc.h:44
StatusCode StatusCodeSvc::finalize ( )
virtual

Finalize (from INITIALIZED to CONFIGURED).

Reimplemented from Service.

Definition at line 83 of file StatusCodeSvc.cpp.

83  {
84 
85  if (m_dat.size() > 0) {
86  MsgStream log( msgSvc(), name() );
87 
88  log << MSG::INFO << "listing all unchecked return codes:" << endmsg;
89 
90  list();
91 
92  }
93 
94  return StatusCode::SUCCESS;
95 
96 }
Definition of the MsgStream class used to transmit messages.
Definition: MsgStream.h:24
SmartIF< IMessageSvc > & msgSvc() const
The standard message service.
virtual void list() const
std::map< std::string, StatCodeDat > m_dat
Definition: StatusCodeSvc.h:44
virtual const std::string & name() const
Retrieve name of the service.
Definition: Service.cpp:331
MsgStream & endmsg(MsgStream &s)
MsgStream Modifier: endmsg. Calls the output method of the MsgStream.
Definition: MsgStream.h:244
StatusCode StatusCodeSvc::initialize ( )
virtual

Initialization (from CONFIGURED to INITIALIZED).

Reimplemented from Service.

Definition at line 38 of file StatusCodeSvc.cpp.

38  {
39 
41  if (!sc.isSuccess()) return sc;
42 
43  MsgStream log( msgSvc(), name() );
44  log << MSG::INFO << "initialize" << endmsg;
45 
46  std::vector<std::string>::const_iterator itr;
47  for (itr = m_pFilter.value().begin(); itr != m_pFilter.value().end(); ++itr) {
48  // we need to do this if someone has gotten to regFnc before initialize
49 
50  string fnc,lib;
51  parseFilter(*itr,fnc,lib);
52 
53  if (fnc != "") {
54  filterFnc(fnc);
55  m_filterfnc.insert(fnc);
56  }
57 
58  if (lib != "") {
59  filterLib(lib);
60  m_filterlib.insert(lib);
61  }
62 
63  }
64 
65  return StatusCode::SUCCESS;
66 
67 }
Definition of the MsgStream class used to transmit messages.
Definition: MsgStream.h:24
SmartIF< IMessageSvc > & msgSvc() const
The standard message service.
bool isSuccess() const
Test for a status code of SUCCESS.
Definition: StatusCode.h:62
void parseFilter(const std::string &str, std::string &fnc, std::string &lib)
This class is used for returning status codes from appropriate routines.
Definition: StatusCode.h:30
std::set< std::string > m_filterfnc
Definition: StatusCodeSvc.h:45
const TYPE & value() const
explicit conversion
Definition: Property.h:355
virtual const std::string & name() const
Retrieve name of the service.
Definition: Service.cpp:331
StringArrayProperty m_pFilter
Definition: StatusCodeSvc.h:41
virtual StatusCode initialize()
Initialization (from CONFIGURED to INITIALIZED).
Definition: Service.cpp:74
void filterLib(const std::string &)
MsgStream & endmsg(MsgStream &s)
MsgStream Modifier: endmsg. Calls the output method of the MsgStream.
Definition: MsgStream.h:244
void filterFnc(const std::string &)
std::set< std::string > m_filterlib
Definition: StatusCodeSvc.h:45
void StatusCodeSvc::list ( ) const
virtual

Implements IStatusCodeSvc.

Definition at line 153 of file StatusCodeSvc.cpp.

153  {
154 
155  MsgStream log( msgSvc(), name() );
156  log << MSG::INFO << endl;
157 
158  map<string,StatCodeDat>::const_iterator itr;
159 
160 #if defined (__GNUC__) && ( __GNUC__ <= 2 )
161  std::ostrstream os;
162 #else
163  std::ostringstream os;
164 #endif
165 
166  os << "Num | Function | Source Library" << endl;
167  os << "----+--------------------------------+-------------------"
168  << "-----------------------" << endl;
169 
170 
171  for(itr = m_dat.begin(); itr != m_dat.end(); ++itr ) {
172  StatCodeDat dat = itr->second;
173 
174  os.width(3);
175  os.setf(ios_base::right,ios_base::adjustfield);
176  os << dat.count;
177 
178  os << " | ";
179  os.width(30);
180  os.setf(ios_base::left,ios_base::adjustfield);
181  os << dat.fnc;
182 
183  os << " | ";
184  os.setf(ios_base::left,ios_base::adjustfield);
185  os << dat.lib;
186 
187  os << endl;
188 
189  }
190 
191 
192  log << os.str() << endmsg;
193 
194 }
Definition of the MsgStream class used to transmit messages.
Definition: MsgStream.h:24
SmartIF< IMessageSvc > & msgSvc() const
The standard message service.
std::map< std::string, StatCodeDat > m_dat
Definition: StatusCodeSvc.h:44
virtual const std::string & name() const
Retrieve name of the service.
Definition: Service.cpp:331
MsgStream & endmsg(MsgStream &s)
MsgStream Modifier: endmsg. Calls the output method of the MsgStream.
Definition: MsgStream.h:244
void StatusCodeSvc::parseFilter ( const std::string &  str,
std::string &  fnc,
std::string &  lib 
)
private

Definition at line 230 of file StatusCodeSvc.cpp.

230  {
231 
232 
233  string::size_type loc = str.find("=");
234  if (loc == std::string::npos) {
235  fnc = str;
236  lib = "";
237  } else {
238  string key,val;
239  key = str.substr(0,loc);
240  val = str.substr(loc+1,str.length()-loc-1);
241 
242  toupper(key);
243 
244  if (key == "FCN" || key == "FNC") {
245  fnc = val;
246  lib = "";
247  } else if (key == "LIB") {
248  fnc = "";
249  lib = val;
250  } else {
251  fnc = "";
252  lib = "";
253 
254  MsgStream log( msgSvc(), name() );
255  log << MSG::WARNING << "ignoring unknown token in Filter: " << str
256  << endmsg;
257  }
258  }
259 
260 }
Definition of the MsgStream class used to transmit messages.
Definition: MsgStream.h:24
SmartIF< IMessageSvc > & msgSvc() const
The standard message service.
virtual const std::string & name() const
Retrieve name of the service.
Definition: Service.cpp:331
void toupper(std::string &s)
MsgStream & endmsg(MsgStream &s)
MsgStream Modifier: endmsg. Calls the output method of the MsgStream.
Definition: MsgStream.h:244
void StatusCodeSvc::regFnc ( const std::string &  func,
const std::string &  lib 
)
virtual

Implements IStatusCodeSvc.

Definition at line 103 of file StatusCodeSvc.cpp.

103  {
104 
107  return;
108  }
109 
110  if (m_dict && lib.rfind("Dict.so") == (lib.length()-7) ) {
111  return;
112  }
113 
114  {
115  const string rlib = lib.substr(lib.rfind("/") + 1);
116 
117  if (m_filterfnc.find(fnc) != m_filterfnc.end() ||
118  m_filterlib.find(rlib) != m_filterlib.end() ) {
119  return;
120  }
121  }
122 
123  if (m_abort) {
124  MsgStream log( msgSvc(), name() );
125  log << MSG::FATAL << "Unchecked StatusCode in " << fnc << " from lib "
126  << lib << endmsg;
127  abort();
128  }
129 
130  string key = fnc + lib;
131 
132  map<string,StatCodeDat>::iterator itr = m_dat.find(key);
133 
134  if (itr != m_dat.end()) {
135  itr->second.count += 1;
136  } else {
137 
138  const string rlib = lib.substr(lib.rfind("/") + 1);
139 
140  StatCodeDat dat;
141  dat.fnc = fnc;
142  dat.lib = rlib;
143  dat.count = 1;
144 
145  m_dat[key] = dat;
146  }
147 
148 }
BooleanProperty m_abort
Definition: StatusCodeSvc.h:42
Definition of the MsgStream class used to transmit messages.
Definition: MsgStream.h:24
Gaudi::StateMachine::State m_state
Service state.
Definition: Service.h:245
BooleanProperty m_dict
Definition: StatusCodeSvc.h:42
SmartIF< IMessageSvc > & msgSvc() const
The standard message service.
std::map< std::string, StatCodeDat > m_dat
Definition: StatusCodeSvc.h:44
std::set< std::string > m_filterfnc
Definition: StatusCodeSvc.h:45
virtual const std::string & name() const
Retrieve name of the service.
Definition: Service.cpp:331
MsgStream & endmsg(MsgStream &s)
MsgStream Modifier: endmsg. Calls the output method of the MsgStream.
Definition: MsgStream.h:244
std::set< std::string > m_filterlib
Definition: StatusCodeSvc.h:45
StatusCode StatusCodeSvc::reinitialize ( )
virtual

Initialization (from INITIALIZED or RUNNING to INITIALIZED, via CONFIGURED).

Reimplemented from Service.

Definition at line 72 of file StatusCodeSvc.cpp.

72  {
73 
74  MsgStream log( msgSvc(), name() );
75  log << MSG::INFO << "reinitialize" << endmsg;
76 
77  return StatusCode::SUCCESS;
78 
79 }
Definition of the MsgStream class used to transmit messages.
Definition: MsgStream.h:24
SmartIF< IMessageSvc > & msgSvc() const
The standard message service.
virtual const std::string & name() const
Retrieve name of the service.
Definition: Service.cpp:331
MsgStream & endmsg(MsgStream &s)
MsgStream Modifier: endmsg. Calls the output method of the MsgStream.
Definition: MsgStream.h:244
virtual bool StatusCodeSvc::suppressCheck ( ) const
inlinevirtual

Implements IStatusCodeSvc.

Definition at line 22 of file StatusCodeSvc.h.

22 { return m_suppress.value() ; }
BooleanProperty m_suppress
Definition: StatusCodeSvc.h:42
const TYPE & value() const
explicit conversion
Definition: Property.h:355

Member Data Documentation

BooleanProperty StatusCodeSvc::m_abort
private

Definition at line 42 of file StatusCodeSvc.h.

std::map<std::string,StatCodeDat> StatusCodeSvc::m_dat
private

Definition at line 44 of file StatusCodeSvc.h.

BooleanProperty StatusCodeSvc::m_dict
private

Definition at line 42 of file StatusCodeSvc.h.

std::set<std::string> StatusCodeSvc::m_filterfnc
private

Definition at line 45 of file StatusCodeSvc.h.

std::set<std::string> StatusCodeSvc::m_filterlib
private

Definition at line 45 of file StatusCodeSvc.h.

StringArrayProperty StatusCodeSvc::m_pFilter
private

Definition at line 41 of file StatusCodeSvc.h.

BooleanProperty StatusCodeSvc::m_suppress
private

Definition at line 42 of file StatusCodeSvc.h.


The documentation for this class was generated from the following files: