LCTL-NODEMAP_ADD_IDMAP(8)

NAME
lctl-nodemap_add_idmap - define ID mappings for a nodemap

SYNOPSIS
lctl nodemap_add_idmap or
lctl nodemap add_idmap --name NODEMAP_NAME --idtype {uid|gid|projid} --idmap CLIENTID[-CLIENTID_END]:FSID[-FSID_END]

DESCRIPTION
nodemap_add_idmap adds an identity mapping to a nodemap. Clients that are members of the given nodemap will have the identities of their users mapped accordingly.

When offsets are defined on the nodemap, any explicit identity mapping should map to an FSID in the offset range [ 0, offset_limit-1 ], otherwise the mapped ID would escape offsetting.

OPTIONS

--name NODEMAP_NAME
    The name of the nodemap that this idmap should be added to.

--idtype {uid|gid|projid}
    Either "uid" or "gid" or "projid" depending on if it is a user ID or group ID or project ID that is to be mapped.

--idmap CLIENTID[-CLIENTID_END]:FSID[-FSID_END]
    The identity to map, and what it should be mapped to. The first number is the ID of the user or group as it is on the client, and the second number is the ID that it should map to on the Lustre filesystem.

EXAMPLES
    # lctl nodemap_add_idmap --name remotesite --idtype uid --idmap 2001:1001
    # lctl nodemap_add_idmap --name remotesite --idtype gid --idmap 2002:1002
    # lctl nodemap_add_idmap --name remotesite --idtype projid --idmap 33:1
    # lctl nodemap_add_idmap --name othersite --idtype uid --idmap 0-999:9000

AVAILABILITY
lctl nodemap_add_idmap is part of the lustre(7) filesystem package since release 2.6.0

SEE ALSO
lustre(7), lctl-nodemap-activate(8), lctl-nodemap-add-offset(8), lctl-nodemap-add-range(8), lctl-nodemap-del(8), lctl-nodemap-del-idmap(8), lctl-nodemap-del-offset(8), lctl-nodemap-del-range(8), lctl-nodemap-modify(8) lctl-nodemap-new(8),