fuidshift(1)

fuidshift1

Uid/gid shifter

Overview

Description:

UID/GID shifter

This tool lets you remap a filesystem tree, switching it from one set of UID/GID ranges to another.

This is mostly useful when retrieving a wrongly shifted filesystem tree from a backup or broken system and having to remap everything either to the host UID/GID range (uid/gid 0 is root) or to an existing container's range.

A range is represented as <u|b|g>:<first_container_id>:<first_host_id>:<size>. Where "u" means shift uid, "g" means shift gid and "b" means shift uid and gid.

Usage:

fuidshift <directory> <range> [<range>...] [flags]

Examples

fuidshift my-dir/ b:0:100000:65536 u:10000:1000:1

Flags:

-h, --help

Print help

-r, --reverse

Perform a reverse mapping

-t, --test

Test mode (no change to files)

--version

Print version number

Releases

2 releases since Debian 12 (Bookworm); the text changed 1 time.

  1. 12
  2. 13

From incus-extra 6.0.4-2+deb13u10 in Debian 13 (Trixie). Also shipped by lxd-tools. Parsed by carta from the page's man source.