| 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 [-h] [-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 -h |
| 37 |
Display usage message. |
| 38 |
.TP |
| 39 |
.B -d |
| 40 |
Performs device discovery only then exits. |
| 41 |
.TP |
| 42 |
.B -f |
| 43 |
Runs |
| 44 |
.B blkmapd |
| 45 |
in the foreground and sends output to stderr (as opposed to syslogd) |
| 46 |
.SH CONFIGURATION FILE |
| 47 |
The |
| 48 |
.B blkmapd |
| 49 |
daemon recognizes the following value from the |
| 50 |
.B [general] |
| 51 |
section of the |
| 52 |
.I /etc/nfs.conf |
| 53 |
configuration file: |
| 54 |
.TP |
| 55 |
.B pipefs-directory |
| 56 |
Tells |
| 57 |
.B blkmapd |
| 58 |
where to look for the rpc_pipefs filesystem. The default value is |
| 59 |
.IR /var/lib/nfs/rpc_pipefs . |
| 60 |
.SH SEE ALSO |
| 61 |
.BR nfs (5), |
| 62 |
.BR dmsetup (8), |
| 63 |
.BR nfs.conf (5) |
| 64 |
.sp |
| 65 |
RFC 5661 for the NFS version 4.1 specification. |
| 66 |
.br |
| 67 |
RFC 5663 for the pNFS block layout specification. |
| 68 |
.SH AUTHORS |
| 69 |
.br |
| 70 |
Haiying Tang <[email protected]> |
| 71 |
.br |
| 72 |
Jim Rees <[email protected]> |