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>