TipcConnGetNode

Name

TipcConnGetNode — get the node name of a connection’s peer process

Synopsis

T_BOOL TipcConnGetNode(conn, node_return) 
T_IPC_CONN conn; 
T_STR *node_return; 

Arguments

conn — connection to get node name from

node_return — storage for connection node name

Return Values

TRUE if the node name was successfully retrieved from the connection, FALSE otherwise.

Diagnostics

If TipcConnGetNode fails, it returns FALSE and sets the global SmartSockets error number to:

Description

TipcConnGetNode gets the node name of a connection’s peer process (the process with which this process is communicating through the connection). The peer process node name can be useful for diagnostic purposes.

Caution

If TipcConnGetNode returns FALSE, it does not store a value in node_return.

The value stored in node_return points directly into an internal data structure and should not be modified.

See Also

TipcConnGetArch, TipcConnGetPid, TipcConnGetUniqueSubject, TipcConnGetUser

Examples

This example prints the node name of a connection’s peer process:

T_STR node; 
 
if (!TipcConnGetNode(conn, &node)) { 
  return;  /* error */ 
}  
 
TutOut("Connection peer process node name is <%s>.\n", node);