Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
GETBSIZE(3)	       FreeBSD Library Functions Manual		   GETBSIZE(3)

NAME
     getbsize -- get preferred block size

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #include <stdlib.h>

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

DESCRIPTION
     The getbsize() function returns a preferred block size for	reporting by
     system utilities df(1), du(1), ls(1) and systat(1), based on the value of
     the BLOCKSIZE environment variable.  BLOCKSIZE may	be specified directly
     in	bytes, or in multiples of a kilobyte by	specifying a number followed
     by	``K'' or ``k'',	in multiples of	a megabyte by specifying a number fol-
     lowed by ``M'' or ``m'' or	in multiples of	a gigabyte by specifying a
     number followed by	``G'' or ``g''.	 Multiples must	be integers.

     Valid values of BLOCKSIZE are 512 bytes to	1 gigabyte.  Sizes less	than
     512 bytes are rounded up to 512 bytes, and	sizes greater than 1 GB	are
     rounded down to 1 GB.  In each case getbsize() produces a warning mes-
     sage.

     The getbsize() function returns a pointer to a null-terminated string
     describing	the block size,	something like ``1K-blocks''.  The memory ref-
     erenced by	headerlenp is filled in	with the length	of the string (not
     including the terminating null).  The memory referenced by	blocksizep is
     filled in with block size,	in bytes.

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

HISTORY
     The getbsize() function first appeared in 4.4BSD.

FreeBSD	10.1		       November	16, 2012		  FreeBSD 10.1

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=getbsize&sektion=3&manpath=FreeBSD+10.0-RELEASE>

home | help