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

FreeBSD Manual Pages

  
 
  

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) and ls(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 message
     via warnx(3).

     The getbsize() function returns a pointer to a null-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 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	13.0			 June 11, 2017			  FreeBSD 13.0

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+13.0-RELEASE>

home | help