configuration

Documentation

Index

• Variables
• type AttributeCachingDuration
  • func (a AttributeCachingDuration) Min(b AttributeCachingDuration) AttributeCachingDuration
• type Mount
  • func NewMountFromConfiguration(configuration *pb.MountConfiguration, fsName string, ...) (Mount, virtual.StatefulHandleAllocator, error)

Variables

var LongAttributeCaching = AttributeCachingDuration{
	// contains filtered or unexported fields
}

LongAttributeCaching indicates that the NFS client may cache file attributes for a long amount of time.

This is a good policy for files or directories that are either fully immutable, or are only mutated through operations performed by the client through the mount point.

var NoAttributeCaching = AttributeCachingDuration{
	// contains filtered or unexported fields
}

NoAttributeCaching indicates that the NFS client should not cache any file attributes, such as size, modification time, permissions and symlink target.

This is a good policy for bb_virtual_tmp's symbolic link, whose target may not be cached.

var ShortAttributeCaching = AttributeCachingDuration{
	// contains filtered or unexported fields
}

ShortAttributeCaching indicates that the NFS client should only cache file attributes for a short amount of time.

This is a good policy for bb_worker's root directory. The contents of this directory change regularly, but there is a very low probability of immediate reuse of build action subdirectories having the same name. It is therefore desirable to have a limited amount of caching.

Types

type AttributeCachingDuration

type AttributeCachingDuration struct {
	// contains filtered or unexported fields
}

AttributeCachingDuration specifies the amount of time attributes of files may be cached by an NFSv4 file system that accesses a virtual file system.

Unlike FUSE, NFSv4.0 provides no facilities for letting the server invalidate information on files cached by the client. To work around this, most NFS clients provide mount options such as 'acregmin', 'acregmax', 'acdirmin' and 'acdirmax' that permit specifying the amount of time attributes may be cached.

func (AttributeCachingDuration) Min

func (a AttributeCachingDuration) Min(b AttributeCachingDuration) AttributeCachingDuration

Min returns the lowest attribute cache duration. This can be used to combine multiple attribute caching durations into a single value, in case the NFS client makes no distinction between individual values.

type Mount

type Mount interface {
	Expose(terminationGroup program.Group, rootDirectory virtual.Directory) error
}

Mount of a virtual file system that has been created using NewMountFromConfiguration(), but that hasn't been exposed to the kernel or network yet. Before calling Expose(), the caller has the possibility to construct a root directory.

func NewMountFromConfiguration

func NewMountFromConfiguration(configuration *pb.MountConfiguration, fsName string, rootDirectoryAttributeCaching, childDirectoriesAttributeCaching, leavesAttributeCaching AttributeCachingDuration) (Mount, virtual.StatefulHandleAllocator, error)

NewMountFromConfiguration creates a new FUSE mount based on options specified in a configuration message and starts processing of incoming requests.