[Previous] [Contents] [Index] [Next]

PhGetConnectInfo()

Get information about a Photon channel

Synopsis:

PhConnectId_t PhGetConnectInfo( 
                  PhConnectId_t coid,
                  PhConnectInfo_t *buf);

Description:

This function fills *buf with information about the specified Photon channel. If coid is zero, information about the calling process is returned. If it isn't zero but doesn't match any existing channel, then the next monotonically greater channel ID is used. If coid is greater than any existing channel ID, -1 is returned and errno is set to ESRCH.

The PhConnectInfo_t structure includes at least the following:

typedef struct _Ph_psinfo {
    unsigned long               flags;
    PhChannelParms_t            parms;
    PhConnectId_t               block;
    unsigned                    num_q_entries;
    unsigned                    buf_len;
    PhConnectId_t               id;
    nid_t                       nid;
    pid_t                       pid;
} PhConnectInfo_t;

Returns:

The channel ID (the same as buf->id), or -1 if the call fails.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PhGetConnectId()


[Previous] [Contents] [Index] [Next]