pccard_lock()

Lock the window of the card in the selected socket

Synopsis:

#include <sys/pccard.h>

int pccard_lock( pccard_t handle, 
                 int socket, 
                 int index, 
                 int oflag );

Library:

libpccard

Description:

The pccard_lock() function call provides exclusive or shared access to the PC Card in socket and also sets access permissions. The parameters are:

handle

Obtained from a previous call to pccard_attach().

socket

Contains both the socket number as well as the function within the socket. This is achieved by shifting the function number left 8 bits and ORing it with the socket number. The socket number is zero based.

index

The window/function number that's to be locked. The window number is obtained from the _pccard_info structure (see pccard_info()).

oflag

Created by ORing the values required (e.g. O_RDWR | O_EXCL) for read/write and exclusive access.

Returns:

A positive integer

Success.

-1

An error occurred (errno is set).

Errors:

EBADF

Invalid handle parameter.

EBUSY

The window is already locked by another process.

ENODEV

Invalid socket parameter, no PC Card is present in the socket, or invalid index parameter.

Examples:

See pccard_arm().

Classification:

QNX 6

See also:

pccard_arm(), pccard_attach()