Viewing: lctl-nodemap-new.8
.TH LCTL-NODEMAP_NEW 8 2025-10-20 Lustre "Lustre Configuration Utilities"
.SH NAME
lctl-nodemap_new \- create a new nodemap to define client behavior
.SH SYNOPSIS
.SY "lctl nodemap_new"
or
.SY "lctl nodemap new"
.RB [ -d | --dynamic ]
.RB [ -p |
.BI --parent " PARENT_NAME"
]
.BI --name " NODEMAP_NAME"
.YS
.SH DESCRIPTION
.B nodemap_new
creates and names a new nodemap to which NID ranges, process identities,
and properties can be added to limit or otherwise manage capabilities
and filesystem access permission of those NID(s).
.SH OPTIONS
.TP
.BR -d ", " --dynamic
Creates a temporary in-memory nodemap on the local node instead of a persistent
one.
.TP
.BI -p ", " --parent " PARENT_NAME"
Mandatory for dynamic nodemap. Specifies the parent nodemap to inherit
properties from. This can be "default".
.TP
.BI --name " NODEMAP_NAME"
The name to give the new nodemap. It can be any alphanumeric string of maximum
length 16, except
.RB \(dq default \(dq.
.SH EXAMPLES
.EX
.B # lctl nodemap_new --name remotesite
.B # lctl nodemap_new --name othersite
.EE
.SH AVAILABILITY
.B lctl nodemap_new
is part of the
.BR lustre (7)
filesystem package since release 2.17.0, but was previously available as
.BR lctl nodemap_add
since release 2.6.0.
.\" Added in commit v2_5_53_0-13-gae295503f5
.SH SEE ALSO
.BR lustre (7),
.BR lctl-nodemap-activate (8),
.BR lctl-nodemap-add-idmap (8),
.BR lctl-nodemap-add-range (8),
.BR lctl-nodemap-del (8),
.BR lctl-nodemap-del-idmap (8),
.BR lctl-nodemap-del-range (8),
.BR lctl-nodemap-modify (8)
