Main Page   Modules   Data Structures   File List   Data Fields   Globals   Related Pages  

gm_node_id_to_host_name.c File Reference

#include "gm_call_trace.h"
#include "gm_debug.h"
#include "gm_debug_yp.h"
#include "gm_internal.h"
#include "gm_lanai_command.h"

Functions

GM_ENTRY_POINT char * gm_node_id_to_host_name (gm_port_t *port, unsigned int node_id)
GM_ENTRY_POINT gm_status_t gm_node_id_to_host_name_ex (gm_port_t *port, unsigned int timeout_usecs, unsigned int node_id, char(*name)[GM_MAX_HOST_NAME_LEN+1])

Detailed Description

This file contains the GM API functions gm_node_id_to_host_name() and gm_node_id_to_host_name_ex().


Function Documentation

GM_ENTRY_POINT char* gm_node_id_to_host_name gm_port_t *    port,
unsigned int    node_id
 

This function is deprecated.

gm_node_id_to_host_name() returns a pointer to the host name of the host containing the network interface card with GM node id node_id. The name referenced by the returned pointer is only valid until the next GM API call.

Return values:
host_name  The host name of the host containing the GM node id node_id.
Parameters:
port  (IN) The GM port associated with the network interface card.
node_id  (IN) The GM node id associated with the network interface card.
Author:
Glenn Brown
Version:
GM_API_VERSION (as defined in gm.h)

GM_ENTRY_POINT gm_status_t gm_node_id_to_host_name_ex gm_port_t *    port,
unsigned int    timeout_usecs,
unsigned int    node_id,
char *    name[GM_MAX_HOST_NAME_LEN+1]
 

Store at *name the host name of the host containing the network interface card with GM node id node_id. The buffer pointed to by name must have at least GM_MAX_HOST_NAME_LEN+1 bytes of storage.

Return values:
host_name  The host name of the host containing the GM node id node_id.
Parameters:
timeout_usecs  (IN) The maximum length of time (in microseconds) to query, or 0 to use the default (long) timeout.
port  (IN) The GM port associated with the network interface card.
node_id  (IN) The GM node id associated with the network interface card.
name  (OUT) Where to store the pointer to the host name.
Author:
Glenn Brown
Version:
GM_API_VERSION (as defined in gm.h)


Generated on Mon Nov 3 15:39:26 2003 for GM by doxygen1.2.15