NAME

rf_getincr − get increment lists

SYNOPSIS

#include <rtfiles.h>

int rf_getincr(fildes, incr, capbufp, buffer, buflen)
int fildes, incr, buflen;
void ∗capbufp, ∗buffer;

DESCRIPTION

The rf_getincr function allows the calling process to obtain the increment list for a capability of the file specified by fildes. 

If fildes specifies a file which is not a directory, then the increment list refers to the file itself.  If fildes specifies a directory, then the increment list refers to files created within that directory. 

Each value in the increment list is a valid value for the capability requested. 

The incr argument specifies which increment list is required:

ATC_ALLOCINCR
Preallocation increment.

ATC_EXTINCR
Extent size increment.

ATC_BIOINCR
Suggested transfer size increment.

ATC_ATINCR
Atomic transfer size increment.

ATC_DIOINCR
Direct I/O transfer size increment.

ATC_DATINCR
Atomic transfer size for Direct I/O increment.

The capbufp argument specifies the capabilities associated with the increment list. 

The buffer argument points to an array of type off_t that shall receive the list. 

The buflen argument indicates the maximum number of list entries that may be returned. 

RETURN VALUE

Upon successful completion, the function rf_getincr returns the number of list entries stored in buffer; otherwise the function returns -1 and sets errno to indicate the error. 

ERRORS

Under the following conditions, the function rf_getincr fails and sets errno to:

­[EBADF] The fildes argument is not a valid file descriptor. 

­[EINVAL] The rf_getincr function is not supported for the specified file or file system. 

­[EINVAL] The specified capability does not have an increment list or an invalid increment list was specified in the incr argument. 

NOTES

At this point, none of the increments on CX systems require increment lists. 

The ATC_EXTINCR no longer applies and should be removed. 

WARNING

rf_getincr is based on IEEE Draft Standard P1003.4/D12.  This is an unapproved draft, subject to change.  Use of information contained in this unapproved draft is at your own risk.  This interface will change to reflect any changes made by future drafts of POSIX 1003.4. 

CX/UX Programmer’s Reference Manual