1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
// Copyright 2020 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 fsbridge provides common interfaces to bridge between VFS1 and VFS2
// files.
package fsbridge
import (
"gvisor.dev/gvisor/pkg/abi/linux"
"gvisor.dev/gvisor/pkg/context"
"gvisor.dev/gvisor/pkg/sentry/memmap"
"gvisor.dev/gvisor/pkg/sentry/vfs"
"gvisor.dev/gvisor/pkg/usermem"
)
// File provides a common interface to bridge between VFS1 and VFS2 files.
type File interface {
// PathnameWithDeleted returns an absolute pathname to vd, consistent with
// Linux's d_path(). In particular, if vd.Dentry() has been disowned,
// PathnameWithDeleted appends " (deleted)" to the returned pathname.
PathnameWithDeleted(ctx context.Context) string
// ReadFull read all contents from the file.
ReadFull(ctx context.Context, dst usermem.IOSequence, offset int64) (int64, error)
// ConfigureMMap mutates opts to implement mmap(2) for the file.
ConfigureMMap(context.Context, *memmap.MMapOpts) error
// Type returns the file type, e.g. linux.S_IFREG.
Type(context.Context) (linux.FileMode, error)
// IncRef increments reference.
IncRef()
// DecRef decrements reference.
DecRef(ctx context.Context)
}
// Lookup provides a common interface to open files.
type Lookup interface {
// OpenPath opens a file.
OpenPath(ctx context.Context, path string, opts vfs.OpenOptions, remainingTraversals *uint, resolveFinal bool) (File, error)
}
|
