srcrrqs Subroutine

AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 2

srcrrqs Subroutine

Purpose

Gets subsystem reply information from the System Resource Controller (SRC) request received.

Library

System Resource Controller Library (libsrc.a)

Syntax

#include <spc.h>

struct srchdr *srcrrqs (Packet)
char *Packet;

Description

The srcrrqs subroutine saves the srchdr information contained in the packet the subsystem received from the System Resource Controller (SRC). The srchdr structure is defined in the spc.h file. This routine must be called by the subsystem to complete the reception process of any packet received from the SRC. The subsystem requires this information to reply to any request that the subsystem receives from the SRC.

Note: The saved srchdr information is overwritten each time this subroutine is called.

Parameters

Packet

Points to the SRC request packet received by the subsystem. If the subsystem received the packet on a message queue, the Packet parameter must point past the message type of the packet to the start of the request information. If the subsystem received the information on a socket, the Packet parameter points to the start of the packet received on the socket.

Return Values

The srcrrqs subroutine returns a pointer to the static srchdr structure, which contains the return address for the subsystem response.

Examples

The following will obtain the subsystem reply information:

int rc;
struct sockaddr addr;
int addrsz;
struct srcreq packet;
 
/* wait to receive packet from SRC daemon */
rc=recvfrom(0, &packet, sizeof(packet), 0, &addr, &addrsz);
/* grab the reply information from the SRC packet */
if (rc>0)
   srchdr=srcrrqs (&packet);

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Files

/dev/SRC	Specifies the AF_UNIX socket file.
/dev/.SRC-unix	Specifies the location for temporary socket files.

Related Information

The srcsbuf subroutine, srcsrpy subroutine, srcsrqt subroutine, srcstat subroutine, srcstathdr subroutine, srcstattxt subroutine, srcstop subroutine, srcstrt subroutine.

List of SRC Subroutines in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

Programming Subsystem Communication with the SRC in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

System Resource Controller (SRC) Overview for Programmers in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.