package fsutil

import "gvisor.dev/gvisor/pkg/fsutil"

Package fsutil contains filesystem utilities that can be shared between the sentry and other sandbox components.

Index ¶

• Variables
• func DirentNames(dirfd int) ([]string, error)
• func ForEachDirent(dirfd int, handleDirent DirentHandler) error
• func ParseDirents(buf []byte, handleDirent DirentHandler)
• func RenameAt(oldDirFD int, oldName string, newDirFD int, newName string) error
• func StatAt(dirFd int, name string) (unix.Stat_t, error)
• func Utimensat(dirFd int, name string, times [2]unix.Timespec, flags int) error
• type DirentHandler

Variables ¶

var UnixDirentMaxSize = int(unsafe.Sizeof(unix.Dirent{}))

UnixDirentMaxSize is the maximum size of unix.Dirent in bytes.

Functions ¶

func DirentNames ¶

func DirentNames(dirfd int) ([]string, error)

DirentNames retrieves all dirents from dirfd using getdents64(2) and returns all the recorded dirent names.

func ForEachDirent ¶

func ForEachDirent(dirfd int, handleDirent DirentHandler) error

ForEachDirent retrieves all dirents from dirfd using getdents64(2) and invokes handleDirent on them.

func ParseDirents ¶

func ParseDirents(buf []byte, handleDirent DirentHandler)

ParseDirents parses dirents from buf. buf must have been populated by getdents64(2) syscall. It calls the handleDirent callback for each dirent.

func RenameAt ¶

func RenameAt(oldDirFD int, oldName string, newDirFD int, newName string) error

RenameAt is a convenience wrapper to make the renameat(2) syscall. It additionally handles empty names.

func StatAt ¶

func StatAt(dirFd int, name string) (unix.Stat_t, error)

StatAt is a convenience wrapper around newfstatat(2).

func Utimensat ¶

func Utimensat(dirFd int, name string, times [2]unix.Timespec, flags int) error

Utimensat is a convenience wrapper to make the utimensat(2) syscall. It additionally handles empty name.

Types ¶

type DirentHandler ¶

type DirentHandler func(ino uint64, off int64, ftype uint8, name string, reclen uint16)

DirentHandler is a function that handles a dirent.

Source Files ¶

fsutil.go fsutil_amd64_unsafe.go fsutil_unsafe.go