FrcaCtrlStart Subroutine

Purpose

Starts the interception of TCP data connections for a previously configured Fast Response Cache Accelerator (FRCA) instance.

Library

FRCA Library (libfrca.a)

Syntax

#include <frca.h>
int32_t FrcaCtrlStart ( FrcaHandle);
int32_t * FrcaHandle;

Description

The FrcaCtrlStart subroutine starts the interception of TCP data connections for an FRCA instance. If the FRCA instance cannot handle the data on that connection, it passes the data to the user-level application that has established the listen socket.

The only FRCA instance type that is currently supported handles static GET requests as part of the Hypertext Transfer Protocol (HTTP).

Parameters

Item Description
FrcaHandle Identifies the FRCA instance on which this operation is performed.

Return Values

Item Description
0 The subroutine completed successfully.
-1 The subroutine failed. The global variable errno is set to indicate the specific type of error.

Error Codes

Item Description
ENOENT The FrcaHandle parameter is invalid.
ENOTREADY The FRCA control instance is in an undefined state.
ENOTSOCK A TCP listen socket that was passed in with the FrcaCtrlCreate cannot be intercepted because it does not exist.