NAME
getbsize —
get user block size
LIBRARY
Standard C Library (libc, -lc)
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 describing the block size,
something like “1K-blocks”. If the
headerlenp parameter is not
NULL
the memory referenced by
headerlenp is filled in with
the length of the string (not including the terminating
NUL
). If the
blocksizep
parameter is not
NULL
the memory referenced by
blocksizep is filled in with 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.