lustre/doc/lctl-nodemap-add-range.8

   1 .TH lctl-nodemap-add-range 8 "2015 Jan 20" Lustre "configuration utilities"
   2 .SH NAME
   3 lctl-nodemap-add-range \- Define a range of NIDs for a nodemap.
   4
   5 .SH SYNOPSIS
   6 .br
   7 .B lctl nodemap_add_range <--name name> <--range range>
   8 .br
   9 .SH DESCRIPTION
  10 .B nodemap_add_range adds a range of NIDs to an existing nodemap. The NID range
  11 cannot overlap with an existing NID range. Clients with NIDs that fall into the
  12 new range will be moved into the given nodemap.
  13
  14 .SH OPTIONS
  15 .I name
  16 is the name of the nodemap that this range should be added to.
  17
  18 .I range
  19 is the NID range that should be added to the nodemap. The syntax for the range
  20 is the same as the rootsquash syntax, with the added constraint that the range
  21 must be contiguous.
  22
  23 .SH Formal LNET Range Definition
  24
  25 .nf
  26 <nidlist>       :== <nidrange> [ ' ' <nidrange> ]
  27 <nidrange>      :== <addrrange> '@' <net>
  28 <addrrange>     :== '*' |
  29                         <ipaddr_range> |
  30                         <numaddr_range>
  31 <ipaddr_range>  :==
  32         <numaddr_range>.<numaddr_range>.<numaddr_range>.<numaddr_range>
  33 <numaddr_range> :== <number> |
  34                         <expr_list>
  35 <expr_list>     :== '[' <range_expr> [ ',' <range_expr>] ']'
  36 <range_expr>    :== <number> |
  37                         <number> '-' <number> |
  38                         <number> '-' <number> '/' <number>
  39 <net>           :== <netname> | <netname><number>
  40 <netname>       :== "lo" | "tcp" | "o2ib" | "cib" | "openib" | "iib" |
  41                         "vib" | "ra" | "elan" | "gm" | "mx" | "ptl"
  42 <number>        :== <nonnegative decimal> | <hexadecimal>
  43 .fi
  44
  45 .SH EXAMPLES
  46 .nf
  47 # lctl nodemap_add_range --name remotesite --range 192.168.1.[1-254]@tcp
  48 # lctl nodemap_add_range --name otherremotesite --range 192.168.2.[1-254]@tcp
  49 .fi
  50
  51 .SH AVAILABILITY
  52 .B lctl
  53 is part of the
  54 .BR Lustre (7)
  55 filesystem package.
  56 .SH SEE ALSO
  57 .BR lustre (7),
  58 .BR lctl-nodemap-activate (8),
  59 .BR lctl-nodemap-add (8),
  60 .BR lctl-nodemap-del (8),
  61 .BR lctl-nodemap-del-range (8),
  62 .BR lctl-nodemap-add-idmap (8),
  63 .BR lctl-nodemap-del-idmap (8),
  64 .BR lctl-nodemap-modify (8)