124 lines
4.4 KiB
Go
124 lines
4.4 KiB
Go
// Copyright 2019 The gVisor Authors.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package vfs
|
|
|
|
import (
|
|
"gvisor.dev/gvisor/pkg/abi/linux"
|
|
)
|
|
|
|
// GetDentryOptions contains options to VirtualFilesystem.GetDentryAt() and
|
|
// FilesystemImpl.GetDentryAt().
|
|
type GetDentryOptions struct {
|
|
// If CheckSearchable is true, FilesystemImpl.GetDentryAt() must check that
|
|
// the returned Dentry is a directory for which creds has search
|
|
// permission.
|
|
CheckSearchable bool
|
|
}
|
|
|
|
// MkdirOptions contains options to VirtualFilesystem.MkdirAt() and
|
|
// FilesystemImpl.MkdirAt().
|
|
type MkdirOptions struct {
|
|
// Mode is the file mode bits for the created directory.
|
|
Mode uint16
|
|
}
|
|
|
|
// MknodOptions contains options to VirtualFilesystem.MknodAt() and
|
|
// FilesystemImpl.MknodAt().
|
|
type MknodOptions struct {
|
|
// Mode is the file type and mode bits for the created file.
|
|
Mode uint16
|
|
|
|
// If Mode specifies a character or block device special file, DevMajor and
|
|
// DevMinor are the major and minor device numbers for the created device.
|
|
DevMajor uint32
|
|
DevMinor uint32
|
|
}
|
|
|
|
// OpenOptions contains options to VirtualFilesystem.OpenAt() and
|
|
// FilesystemImpl.OpenAt().
|
|
type OpenOptions struct {
|
|
// Flags contains access mode and flags as specified for open(2).
|
|
//
|
|
// FilesystemImpls is reponsible for implementing the following flags:
|
|
// O_RDONLY, O_WRONLY, O_RDWR, O_APPEND, O_CREAT, O_DIRECT, O_DSYNC,
|
|
// O_EXCL, O_NOATIME, O_NOCTTY, O_NONBLOCK, O_PATH, O_SYNC, O_TMPFILE, and
|
|
// O_TRUNC. VFS is responsible for handling O_DIRECTORY, O_LARGEFILE, and
|
|
// O_NOFOLLOW. VFS users are responsible for handling O_CLOEXEC, since file
|
|
// descriptors are mostly outside the scope of VFS.
|
|
Flags uint32
|
|
|
|
// If FilesystemImpl.OpenAt() creates a file, Mode is the file mode for the
|
|
// created file.
|
|
Mode uint16
|
|
}
|
|
|
|
// ReadOptions contains options to FileDescription.PRead(),
|
|
// FileDescriptionImpl.PRead(), FileDescription.Read(), and
|
|
// FileDescriptionImpl.Read().
|
|
type ReadOptions struct {
|
|
// Flags contains flags as specified for preadv2(2).
|
|
Flags uint32
|
|
}
|
|
|
|
// RenameOptions contains options to VirtualFilesystem.RenameAt() and
|
|
// FilesystemImpl.RenameAt().
|
|
type RenameOptions struct {
|
|
// Flags contains flags as specified for renameat2(2).
|
|
Flags uint32
|
|
}
|
|
|
|
// SetStatOptions contains options to VirtualFilesystem.SetStatAt(),
|
|
// FilesystemImpl.SetStatAt(), FileDescription.SetStat(), and
|
|
// FileDescriptionImpl.SetStat().
|
|
type SetStatOptions struct {
|
|
// Stat is the metadata that should be set. Only fields indicated by
|
|
// Stat.Mask should be set.
|
|
//
|
|
// If Stat specifies that a timestamp should be set,
|
|
// FilesystemImpl.SetStatAt() and FileDescriptionImpl.SetStat() must
|
|
// special-case StatxTimestamp.Nsec == UTIME_NOW as described by
|
|
// utimensat(2); however, they do not need to check for StatxTimestamp.Nsec
|
|
// == UTIME_OMIT (VFS users must unset the corresponding bit in Stat.Mask
|
|
// instead).
|
|
Stat linux.Statx
|
|
}
|
|
|
|
// StatOptions contains options to VirtualFilesystem.StatAt(),
|
|
// FilesystemImpl.StatAt(), FileDescription.Stat(), and
|
|
// FileDescriptionImpl.Stat().
|
|
type StatOptions struct {
|
|
// Mask is the set of fields in the returned Statx that the FilesystemImpl
|
|
// or FileDescriptionImpl should provide. Bits are as in linux.Statx.Mask.
|
|
//
|
|
// The FilesystemImpl or FileDescriptionImpl may return fields not
|
|
// requested in Mask, and may fail to return fields requested in Mask that
|
|
// are not supported by the underlying filesystem implementation, without
|
|
// returning an error.
|
|
Mask uint32
|
|
|
|
// Sync specifies the synchronization required, and is one of
|
|
// linux.AT_STATX_SYNC_AS_STAT (which is 0, and therefore the default),
|
|
// linux.AT_STATX_SYNC_FORCE_SYNC, or linux.AT_STATX_SYNC_DONT_SYNC.
|
|
Sync uint32
|
|
}
|
|
|
|
// WriteOptions contains options to FileDescription.PWrite(),
|
|
// FileDescriptionImpl.PWrite(), FileDescription.Write(), and
|
|
// FileDescriptionImpl.Write().
|
|
type WriteOptions struct {
|
|
// Flags contains flags as specified for pwritev2(2).
|
|
Flags uint32
|
|
}
|