TipcConnGetArch

Name

TipcConnGetArch — get the architecture name of a connection’s peer process

Synopsis

T_BOOL TipcConnGetArch(conn, arch_return) 
T_IPC_CONN conn; 
T_STR *arch_return; 

Arguments

conn — connection to get architecture name from

arch_return — storage for connection architecture name

Return Values

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

Diagnostics

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

Description

TipcConnGetArch gets the architecture name of a connection’s peer process (the process that this process is communicating with). The peer process architecture name is useful for diagnostic purposes. The architecture name is the SmartSockets architecture of the form Machine_OperatingSystem (for example, sun4_solaris). This value is stored in:

the environment variable RTARCH 

the logical RTARCH 

the environment variable RTARCH 

Caution

If TipcConnGetArch returns FALSE, it does not store a value in arch_return.

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

See Also

TipcConnGetNode, TipcConnGetPid, TipcConnGetUniqueSubject, TipcConnGetUser

Examples

This code fragment prints the architecture name of a connection’s peer process:

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