nfsidmap: Added Error Logging
[nfs-utils.git] / utils / blkmapd / blkmapd.man
1 .\"
2 .\" Copyright 2011, Jim Rees.
3 .\"
4 .\" You may distribute under the terms of the GNU General Public
5 .\" License as specified in the file COPYING that comes with the
6 .\" nfs-utils distribution.
7 .\"
8 .TH blkmapd 8 "11 August 2011"
9 .SH NAME
10 blkmapd \- pNFS block layout mapping daemon
11 .SH SYNOPSIS
12 .B "blkmapd [-d] [-f]"
13 .SH DESCRIPTION
14 The
15 .B blkmapd
16 daemon performs device discovery and mapping for the parallel NFS (pNFS) block layout
17 client [RFC5663].
18 .PP
19 The pNFS block layout protocol builds a complex storage hierarchy from a set
20 of
21 .I simple volumes.
22 These simple volumes are addressed by content, using a signature on the
23 volume to uniquely name each one.
24 The daemon locates a volume by examining each block device in the system for
25 the given signature.
26 .PP
27 The topology typically consists of a hierarchy of volumes built by striping,
28 slicing, and concatenating the simple volumes.
29 The
30 .B blkmapd
31 daemon uses the device-mapper driver to construct logical devices that
32 reflect the server topology, and passes these devices to the kernel for use
33 by the pNFS block layout client.
34 .SH OPTIONS
35 .TP
36 .B -d
37 Performs device discovery only then exits.
38 .TP
39 .B -f
40 Runs
41 .B blkmapd
42 in the foreground and sends output to stderr (as opposed to syslogd)
43 .SH SEE ALSO
44 .BR nfs (5),
45 .BR dmsetup (8)
46 .sp
47 RFC 5661 for the NFS version 4.1 specification.
48 .br
49 RFC 5663 for the pNFS block layout specification.
50 .SH AUTHORS
51 .br
52 Haiying Tang <Tang_Haiying@emc.com>
53 .br
54 Jim Rees <rees@umich.edu>