LFS_MARKV(2) BSD System Calls Manual LFS_MARKV(2)NAME
lfs_markv -- rewrite disk blocks to new disk locations
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <sys/types.h>
#include <ufs/lfs/lfs.h>
int
lfs_markv(fsid_t *fsidp, BLOCK_INFO *blkiov, int blkcnt);
DESCRIPTION
lfs_markv() rewrites the blocks specified in blkiov to new disk locations, for the purposes of grouping them next to one another, or to move
them out of a segment to clean it. All fields of the BLOCK_INFO structure must be filled in, except for bi_segcreate. If bi_daddr is not
the correct current address for logical block bi_lbn of the file with inode number bi_inode, or if the file's version number does not match
bi_version, the block will not be written to disk, but no error will be returned.
The fsidp argument contains the id of the filesystem to which the inodes and blocks belong. The bi_bp field contains bi_size bytes of data
to be written into the appropriate block. If bi_lbn is specified as LFS_UNUSED_LBN, the inode itself will be rewritten.
The blkiov argument is an array of BLOCK_INFO structures (see below). The blkcnt argument determines the size of the blkiov array.
typedef struct block_info {
ino_t bi_inode; /* inode # */
ufs_daddr_t bi_lbn; /* logical block w/in file */
ufs_daddr_t bi_daddr; /* disk address of block */
time_t bi_segcreate; /* origin segment create time */
int bi_version; /* file version number */
void *bi_bp; /* data buffer */
int bi_size; /* size of the block (if fragment) */
} BLOCK_INFO;
RETURN VALUES
lfs_markv() returns 0 on success, or -1 on error.
ERRORS
An error return from lfs_markv() indicates:
[EFAULT] fsidp points outside the process's allocated address space.
[EINVAL] *fsidp does not specify a valid filesystem.
[EBUSY] One or more of the inodes whose blocks were to be written was locked, and its blocks were not rewritten.
SEE ALSO lfs_segclean(2), lfs_segwait(2), lfs_cleanerd(8)HISTORY
The lfs_markv() function call appeared in 4.4BSD.
BUGS
The functionality of lfs_markv() does not really belong in user space. Among other things it could be used to work around the SF_IMMUTABLE
and SF_APPEND file flags (see chflags(2)).
BSD May 23, 2000 BSD
Check Out this Related Man Page
df_hfs(1M)df_hfs(1M)NAME
df_hfs: df - report number of free CDFS, HFS, or NFS file system disk blocks
SYNOPSIS
FStype] specific_options] [special|directory]...
DESCRIPTION
The command displays the number of free 512-byte blocks and free inodes available for file systems by examining the counts kept in the
superblock or superblocks. If a special or a directory is not specified, the free space on all mounted file systems is displayed. If the
arguments to are path names, reports on the file systems containing the named files. If the argument to is a special of an unmounted file
system, the free space in the unmounted file system is displayed.
Options
recognizes the following options:
Report only the number of kilobytes (KB) free.
Report the total number of blocks allocated for swapping to the file system
as well as the number of blocks free for swapping to the file system. This option is supported on HFS file systems
only.
Report the number of files free.
Report only the actual count of the blocks in the free list
(free inodes are not reported). When this option is specified, reports on raw devices.
Report only on the
FStype file system type (see fstyp(1M)). For the purposes of this manual entry, FStype can be one of and for the
CDFS, HFS, and NFS file systems, respectively.
Report the entire structure described in
statvfs(2).
Report the total number of inodes,
the number of free inodes, number of used inodes, and the percentage of inodes in use.
Report the allocation in kilobytes (KB).
Report on local file systems only.
Report the file system name.
If used with no other options, display a list of mounted file system types.
Specify options specific to the HFS file system type.
specific_options is a comma-separated list of suboptions.
The available suboption is:
Report the number of used and free inodes.
Report the total allocated block figures and the number of free blocks.
Report the percentage of blocks used,
the number of blocks used, and the number of blocks free. This option cannot be used with other options.
Echo the completed command line, but perform no other action.
The command line is generated by incorporating the user-specified options and other information derived from This
option allows the user to verify the command line.
When is used on an HFS file system, the file space reported is the space available to the ordinary user, and does not include the reserved
file space specified by
Unreported reserved blocks are available only to users who have appropriate privileges. See tunefs(1M) for information about
When is used on NFS file systems, the number of inodes is displayed as -1 . This is due to superuser access restrictions over NFS.
EXAMPLES
Report the number of free disk blocks for all mounted file systems:
Report the number of free disk blocks for all mounted HFS file systems:
Report the number of free files for all mounted NFS file systems:
Report the total allocated block figures and the number of free blocks, for all mounted file systems:
Report the total allocated block figures and the number of free blocks, for the file system mounted as /usr:
WARNINGS
does not account for:
o Disk space reserved for swap space,
o Space used for the HFS boot block (8K bytes, 1 per file system),
o HFS superblocks (8K bytes each, 1 per disk cylinder),
o HFS cylinder group blocks (1K-8K bytes each, 1 per cylinder group),
o Inodes (currently 128 bytes reserved for each inode).
Non-HFS file systems may have other items that this command does not account for.
The option, from prior releases, has been replaced by the option.
FILES
File system devices.
Static information about the file systems
Mounted file system table
SEE ALSO du(1), df(1M), fsck(1M), fstab(4), fstyp(1M), statvfs(2), mnttab(4).
STANDARDS CONFORMANCE df_hfs(1M)