idmapper

package module

v0.0.0-...-3465c44 Latest Latest Go to latest Published: Apr 22, 2024 License: Apache-2.0 Imports: 5 Imported by: 8

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/cloudfoundry/idmapper

Links

Open Source Insights

README ¶

IdMapper

idmapper is a package which will map a process to the highest user id available. It was created to be used by GrootFS, a root filesystem manager for CloudFoundry's container runtime.

Unlike the newuidmap and newgidmap commands found in Shadow, idmapper does not require this user to exist and will not check /etc/subuid for valid subuid ranges.

Commands

`newuidmap` / `newgidmap`

Will map the given process to the maximum user id available e.g.

$ newuidmap <process id>
$ newgidmap <process id>

`maximus`

Will return the maximum user id available.

$ maximus
# => 4294967294

`idmapper` package

This can be used by importing:

"code.cloudfoundry.org/idmapper"

Documentation ¶

Index ¶

func Max(a, b int) int
func Min(a, b int) int
func MustGetMaxValidGID() int
func MustGetMaxValidUID() int
type IDMap
- func (u IDMap) MaxValid() (int, error)
type MappingList
- func (m MappingList) Map(id int) int
- func (m MappingList) String() string
type ParseError
- func (p ParseError) Error() string

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Max ¶

func Max(a, b int) int

func Min ¶

func Min(a, b int) int

func MustGetMaxValidGID ¶

func MustGetMaxValidGID() int

func MustGetMaxValidUID ¶

func MustGetMaxValidUID() int

Types ¶

type IDMap ¶

type IDMap string

const DefaultGIDMap IDMap = "/proc/self/gid_map"

const DefaultUIDMap IDMap = "/proc/self/uid_map"

func (IDMap) MaxValid ¶

func (u IDMap) MaxValid() (int, error)

type MappingList ¶

type MappingList []specs.LinuxIDMapping

func (MappingList) Map ¶

func (m MappingList) Map(id int) int

func (MappingList) String ¶

func (m MappingList) String() string

type ParseError ¶

type ParseError struct {
	Line string
	Err  error
}

func (ParseError) Error ¶

func (p ParseError) Error() string

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
cmd
maximus
newgidmap
newuidmap
integration
wrapper

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL