fileOf - discover file associated with a Shore pool or index

SYNOPSIS
DESCRIPTION
ARGUMENTS
ENVIRONMENT
ERRORS
VERSION
SPONSORSHIP
COPYRIGHT
SEE ALSO

SYNOPSIS

VASResult       shore_vas::fileOf(
    const lrid_t        &obj,    // oid of pool or index
    lrid_t                *fid     // ptr may not be null
);

DESCRIPTION

FileOf returns the Storage Manager's file identifier for the file or index associated with a given pool or index.

ARGUMENTS

The argument obj is the full logical object identifier of the pool or index.

The argument fid points to a place in the caller's address space into which the SVAS will write the result; fid may not be null.

ENVIRONMENT

FileOf is available on both the server and clients. Its purpose is to assist the bulk-loader, the disk utilization utilities, the tester, and other value-added servers.

ERRORS

The return values are valid only if fileOf returns ST_OK. Locks are acquired for the object in question, so deadlock may occur. See transaction(svas) for information about deadlocks.

A complete list of errors is in errors(svas).

VERSION

This manual page applies to Version 1.1.1 of the Shore software.

SPONSORSHIP

The Shore project is sponsored by the Advanced Research Project Agency, ARPA order number 018 (formerly 8230), monitored by the U.S. Army Research Laboratory under contract DAAB07-91-C-Q518.

CONTENTS