Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

malloc(3C)

rf_freebuf(3P4)

rf_getbuf(3P4)

NAME

rf_getbuf − allocate a suitably aligned data buffer

SYNOPSIS

#include <rtfiles.h>

void ∗rf_getbuf(bufsize, align)
off_t bufsize, align;

DESCRIPTION

The rf_getbuf function returns a pointer to a suitably aligned buffer of size bufsize.  The buffer will start on an address that is aligned modulo align. 

RETURN VALUE

Upon successful completion, the function rf_getbuf returns a pointer to a suitably aligned buffer; otherwise it returns a value of -1 and sets errno to indicate the error. 

ERRORS

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

­[ENOMEM] A buffer area of the requested size could not be allocated. 

SEE ALSO

malloc(3C), rf_freebuf(3P4)

WARNING

rf_getbuf 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

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026