GETBSIZE(3)               OpenBSD Programmer's Manual              GETBSIZE(3)

NAME
     getbsize - get user block size

SYNOPSIS
     #include <stdlib.h>

     char *
     getbsize(int *headerlenp, long *blocksizep);

DESCRIPTION
     The getbsize() function determines the user's preferred block size based
     on the value of the BLOCKSIZE environment variable; see environ(7) for
     details on its use and format.

     The getbsize() function returns a pointer to a NUL-terminated string de-
     scribing the block size, something like "1K-blocks".  The memory refer-
     enced by headerlenp is filled in with the length of the string (not in-
     cluding the terminating NUL byte).  The memory referenced by blocksizep
     is filled in with the block size, in bytes.

     If the user's block size is unreasonable, a warning message is written to
     standard error and the returned information reflects a block size of 512
     bytes.

SEE ALSO
     df(1), du(1), ls(1), systat(1), environ(7)

HISTORY
     The getbsize function first appeared in 4.4BSD.

OpenBSD 4.0                      June 4, 1993                                1
