NAME

Pfs_OpenConnection − Create a pseudo-device connection to a pseudo-file-system

SYNOPSIS

#include <pdev.h>
Pdev_Stream ∗
Pfs_OpenConnection(pfsToken, idSize, idPtr, service)

ARGUMENTS

Pfs_Token ∗pfsToken   (in) Return value of Pfs_Open call. 

int idSize   (in) Size of the ID. 

Address idPtr   (in) Pointer to server’s name for this connection. 

Pdev_Callbacks ∗service   (in) Array of pseudo-device call-back procedures. 
 

DESCRIPTION

Pfs_OpenConnection is used to establish a pseudo-device connection in response to an open request to a pseudo-file-system server.  The pfsToken argument is the return value of the Pfs_Open call used to establish the server of the pseudo-file-system.  The idPtr references the server’s identifier for the pseudo-device connection.  If the file being opened is a directory then this identifier may be passed back as the prefixID for naming operations that are relative to the directory.  The service argument is a set of call-back procedures that are invoked by the Pdev library in response to subsequent operations on the file.  See the Pdev_Open man page for a description of how these call-backs are invoked.  Any of the elements of service can be NULL pointers in which case a default, no-op handler is used by the Pdev library. 

The return value of Pfs_OpenConnection is a token for the connection.  It contains the streamID of the server’s half of the connection on which various I/O controls can be done.  It also contains a clientData field for use by the caller of Pfs_OpenConnection.  This token is passed into all of the pseudo-device service call-backs. 

SEE ALSO

Pfs_Open, Pdev_SetHandler, pdev

KEYWORDS

pseudo-device, pseudo-file-system, call-back
 

Sprite version 1.0  —  January 27, 1989