The nova.cmd.idmapshift Module


IDMapShift is a tool that properly sets the ownership of a filesystem for use with linux user namespaces.


nova-idmapshift -i -u 0:10000:2000 -g 0:10000:2000 path

This command will idempotently shift path to proper ownership using the provided uid and gid mappings.


nova-idmapshift -i -c -d -v
-u [[guest-uid:host-uid:count],...] -g [[guest-gid:host-gid:count],...] -n [nobody-id] path

path: Root path of the filesystem to be shifted

-i, –idempotent: Shift operation will only be performed if filesystem appears unshifted

-c, –confirm: Will perform check on filesystem Returns 0 when filesystem appears shifted Returns 1 when filesystem appears unshifted

-d, –dry-run: Print chown operations, but won’t perform them

-v, –verbose: Print chown operations while performing them

-u, –uid: User ID mappings, maximum of 3 ranges

-g, –gid: Group ID mappings, maximum of 3 ranges

-n, –nobody: ID to map all unmapped uid and gids to.


When using user namespaces with linux containers, the filesystem of the container must be owned by the targeted user and group ids being applied to that container. Otherwise, processes inside the container won’t be able to access the filesystem.

For example, when using the id map string ‘0:10000:2000’, this means that user ids inside the container between 0 and 1999 will map to user ids on the host between 10000 and 11999. Root (0) becomes 10000, user 1 becomes 10001, user 50 becomes 10050 and user 1999 becomes 11999. This means that files that are owned by root need to actually be owned by user 10000, and files owned by 50 need to be owned by 10050, and so on.

IDMapShift will take the uid and gid strings used for user namespaces and properly set up the filesystem for use by those users. Uids and gids outside of provided ranges will be mapped to nobody (max uid/gid) so that they are inaccessible inside the container.

confirm_dir(fsdir, uid_mappings, gid_mappings, nobody)
confirm_path(path, uid_ranges, gid_ranges, nobody)
find_target_id(fsid, mappings, nobody, memo)
print_chown(path, uid, gid, target_uid, target_gid)
shift_dir(fsdir, uid_mappings, gid_mappings, nobody, dry_run=False, verbose=False)
shift_path(path, uid_mappings, gid_mappings, nobody, uid_memo, gid_memo, dry_run=False, verbose=False)

Table Of Contents

Previous topic

The nova.cmd.dhcpbridge Module

Next topic

The nova.cmd.manage Module

Project Source

This Page