libdokan

package
v0.0.0-...-48c56db Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 23, 2021 License: BSD-3-Clause, BSD-3-Clause Imports: 35 Imported by: 0

README

Library code gluing together KBFS and the Dokan protocol.

(TODO: Fill in more details.)

Documentation

Overview

Package libdokan is an interface between libkbfs and dokan.

Index

Constants

View Source 
const (
	// PublicName is the name of the parent of all public top-level folders.
	PublicName = "public"

	// PrivateName is the name of the parent of all private top-level folders.
	PrivateName = "private"

	// TeamName is the name of the parent of all team top-level folders.
	TeamName = "team"

	// CtxOpID is the display name for the unique operation Dokan ID tag.
	CtxOpID = "DID"

	// WrongUserErrorFileName is the name of error directory for other users.
	WrongUserErrorFileName = `kbfs.access.denied.for.other.windows.users.txt`

	// WrongUserErrorContents is the contents of the file.
	WrongUserErrorContents = `Access to KBFS is limited to the windows user (sid) running KBFS.`
)
View Source 
const DefaultMountFlags = dokan.CurrentSession

DefaultMountFlags are the default mount flags for libdokan.

View Source 
const HiddenFilePrefix = `._`

HiddenFilePrefix is the prefix for files to be hidden.

Variables

This section is empty.

Functions

func Start 

func Start(options StartOptions, kbCtx libkbfs.Context) *libfs.Error

Start the filesystem

Types

type Alias 

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

Alias is a top-level folder accessed through its non-canonical name.

func (Alias) CanDeleteDirectory 

func (t Alias) CanDeleteDirectory(ctx context.Context, fi *dokan.FileInfo) error

func (Alias) CanDeleteFile 

func (t Alias) CanDeleteFile(ctx context.Context, fi *dokan.FileInfo) error

func (Alias) Cleanup 

func (t Alias) Cleanup(ctx context.Context, fi *dokan.FileInfo)

func (Alias) CloseFile 

func (t Alias) CloseFile(ctx context.Context, fi *dokan.FileInfo)

func (Alias) FindFiles 

func (t Alias) FindFiles(ctx context.Context, fi *dokan.FileInfo, ignored string, cb func(*dokan.NamedStat) error) error

func (Alias) FlushFileBuffers 

func (t Alias) FlushFileBuffers(ctx context.Context, fi *dokan.FileInfo) error

func (*Alias) GetFileInformation 

func (s *Alias) GetFileInformation(context.Context, *dokan.FileInfo) (a *dokan.Stat, err error)

GetFileInformation for dokan.

func (Alias) GetFileSecurity 

func (t Alias) GetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (Alias) LockFile 

func (t Alias) LockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (Alias) ReadFile 

func (t Alias) ReadFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

func (Alias) SetAllocationSize 

func (t Alias) SetAllocationSize(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (Alias) SetEndOfFile 

func (t Alias) SetEndOfFile(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (Alias) SetFileAttributes 

func (t Alias) SetFileAttributes(ctx context.Context, fi *dokan.FileInfo, fileAttributes dokan.FileAttribute) error

func (Alias) SetFileSecurity 

func (t Alias) SetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (Alias) SetFileTime 

func (t Alias) SetFileTime(context.Context, *dokan.FileInfo, time.Time, time.Time, time.Time) error

func (Alias) UnlockFile 

func (t Alias) UnlockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (Alias) WriteFile 

func (t Alias) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

type CtxTagKey 

type CtxTagKey int

CtxTagKey is the type used for unique context tags 

const (
	// CtxIDKey is the type of the tag for unique operation IDs.
	CtxIDKey CtxTagKey = iota
)

type Dir 

type Dir struct {
	FSO
}

Dir represents KBFS subdirectories.

func (*Dir) CanDeleteDirectory 

func (d *Dir) CanDeleteDirectory(ctx context.Context, fi *dokan.FileInfo) (err error)

CanDeleteDirectory - return just nil TODO check for permissions here.

func (Dir) CanDeleteFile 

func (t Dir) CanDeleteFile(ctx context.Context, fi *dokan.FileInfo) error

func (*Dir) Cleanup 

func (d *Dir) Cleanup(ctx context.Context, fi *dokan.FileInfo)

Cleanup - forget references, perform deletions etc. If Cleanup is called with non-nil FileInfo that has IsDeleteOnClose() no libdokan locks should be held prior to the call.

func (Dir) CloseFile 

func (t Dir) CloseFile(ctx context.Context, fi *dokan.FileInfo)

func (*Dir) FindFiles 

func (d *Dir) FindFiles(ctx context.Context, fi *dokan.FileInfo, ignored string, callback func(*dokan.NamedStat) error) (err error)

FindFiles does readdir for dokan.

func (Dir) FlushFileBuffers 

func (t Dir) FlushFileBuffers(ctx context.Context, fi *dokan.FileInfo) error

func (*Dir) GetFileInformation 

func (d *Dir) GetFileInformation(ctx context.Context, fi *dokan.FileInfo) (st *dokan.Stat, err error)

GetFileInformation for dokan.

func (Dir) GetFileSecurity 

func (t Dir) GetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (Dir) LockFile 

func (t Dir) LockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (Dir) ReadFile 

func (t Dir) ReadFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

func (Dir) SetAllocationSize 

func (t Dir) SetAllocationSize(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (Dir) SetEndOfFile 

func (t Dir) SetEndOfFile(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (*Dir) SetFileAttributes 

func (d *Dir) SetFileAttributes(ctx context.Context, fi *dokan.FileInfo, fileAttributes dokan.FileAttribute) error

SetFileAttributes for Dokan.

func (Dir) SetFileSecurity 

func (t Dir) SetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (Dir) UnlockFile 

func (t Dir) UnlockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (Dir) WriteFile 

func (t Dir) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

type EmptyFolder 

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

EmptyFolder represents an empty, read-only KBFS TLF that has not been created by someone with sufficient permissions.

func (EmptyFolder) CanDeleteDirectory 

func (t EmptyFolder) CanDeleteDirectory(ctx context.Context, fi *dokan.FileInfo) error

func (EmptyFolder) CanDeleteFile 

func (t EmptyFolder) CanDeleteFile(ctx context.Context, fi *dokan.FileInfo) error

func (EmptyFolder) Cleanup 

func (t EmptyFolder) Cleanup(ctx context.Context, fi *dokan.FileInfo)

func (EmptyFolder) CloseFile 

func (t EmptyFolder) CloseFile(ctx context.Context, fi *dokan.FileInfo)

func (*EmptyFolder) FindFiles 

func (*EmptyFolder) FindFiles(ctx context.Context, fi *dokan.FileInfo, ignored string, callback func(*dokan.NamedStat) error) (err error)

FindFiles for dokan.

func (EmptyFolder) FlushFileBuffers 

func (t EmptyFolder) FlushFileBuffers(ctx context.Context, fi *dokan.FileInfo) error

func (*EmptyFolder) GetFileInformation 

func (*EmptyFolder) GetFileInformation(context.Context, *dokan.FileInfo) (a *dokan.Stat, err error)

GetFileInformation for dokan.

func (EmptyFolder) GetFileSecurity 

func (t EmptyFolder) GetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (EmptyFolder) LockFile 

func (t EmptyFolder) LockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (EmptyFolder) ReadFile 

func (t EmptyFolder) ReadFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

func (EmptyFolder) SetAllocationSize 

func (t EmptyFolder) SetAllocationSize(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (EmptyFolder) SetEndOfFile 

func (t EmptyFolder) SetEndOfFile(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (EmptyFolder) SetFileAttributes 

func (t EmptyFolder) SetFileAttributes(ctx context.Context, fi *dokan.FileInfo, fileAttributes dokan.FileAttribute) error

func (EmptyFolder) SetFileSecurity 

func (t EmptyFolder) SetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (EmptyFolder) SetFileTime 

func (t EmptyFolder) SetFileTime(context.Context, *dokan.FileInfo, time.Time, time.Time, time.Time) error

func (EmptyFolder) UnlockFile 

func (t EmptyFolder) UnlockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (EmptyFolder) WriteFile 

func (t EmptyFolder) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

type FS 

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

FS implements the newfuse FS interface for KBFS.

func NewFS 

func NewFS(ctx context.Context, config libkbfs.Config, log logger.Logger) (*FS, error)

NewFS creates an FS

func (*FS) CreateFile 

func (f *FS) CreateFile(ctx context.Context, fi *dokan.FileInfo, cd *dokan.CreateData) (dokan.File, dokan.CreateStatus, error)

CreateFile called from dokan, may be a file or directory.

func (*FS) ErrorPrint 

func (f *FS) ErrorPrint(err error)

ErrorPrint prints errors from the Dokan library.

func (*FS) GetDiskFreeSpace 

func (f *FS) GetDiskFreeSpace(ctx context.Context) (freeSpace dokan.FreeSpace, err error)

GetDiskFreeSpace returns information about free space on the volume for dokan.

func (*FS) GetVolumeInformation 

func (f *FS) GetVolumeInformation(ctx context.Context) (dokan.VolumeInformation, error)

GetVolumeInformation returns information about the whole filesystem for dokan.

func (*FS) MoveFile 

func (f *FS) MoveFile(ctx context.Context, src dokan.File, sourceFI *dokan.FileInfo, targetPath string, replaceExisting bool) (err error)

MoveFile tries to move a file.

func (*FS) NotificationGroupWait 

func (f *FS) NotificationGroupWait()

NotificationGroupWait waits till the local notification group is done.

func (*FS) Printf 

func (f *FS) Printf(fmt string, args ...interface{})

Printf prints information from the Dokan library.

func (*FS) UserChanged 

func (f *FS) UserChanged(ctx context.Context, oldName, newName kbname.NormalizedUsername)

UserChanged is called from libfs.

func (*FS) WithContext 

func (f *FS) WithContext(ctx context.Context) (context.Context, context.CancelFunc)

WithContext creates context for filesystem operations.

type FSO 

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

FSO is a common type for file system objects, i.e. Dirs or Files.

func (FSO) CanDeleteDirectory 

func (t FSO) CanDeleteDirectory(ctx context.Context, fi *dokan.FileInfo) error

func (FSO) CanDeleteFile 

func (t FSO) CanDeleteFile(ctx context.Context, fi *dokan.FileInfo) error

func (FSO) Cleanup 

func (t FSO) Cleanup(ctx context.Context, fi *dokan.FileInfo)

func (FSO) CloseFile 

func (t FSO) CloseFile(ctx context.Context, fi *dokan.FileInfo)

func (FSO) FindFiles 

func (t FSO) FindFiles(ctx context.Context, fi *dokan.FileInfo, ignored string, cb func(*dokan.NamedStat) error) error

func (FSO) FlushFileBuffers 

func (t FSO) FlushFileBuffers(ctx context.Context, fi *dokan.FileInfo) error

func (FSO) GetFileSecurity 

func (t FSO) GetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (FSO) LockFile 

func (t FSO) LockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (FSO) ReadFile 

func (t FSO) ReadFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

func (FSO) SetAllocationSize 

func (t FSO) SetAllocationSize(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (FSO) SetEndOfFile 

func (t FSO) SetEndOfFile(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (FSO) SetFileAttributes 

func (t FSO) SetFileAttributes(ctx context.Context, fi *dokan.FileInfo, fileAttributes dokan.FileAttribute) error

func (FSO) SetFileSecurity 

func (t FSO) SetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (*FSO) SetFileTime 

func (f *FSO) SetFileTime(ctx context.Context, fi *dokan.FileInfo, creation time.Time, lastAccess time.Time, lastWrite time.Time) (err error)

SetFileTime sets mtime for FSOs (File and Dir). TLFs have a separate SetFileTime.

func (FSO) UnlockFile 

func (t FSO) UnlockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (FSO) WriteFile 

func (t FSO) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

type File 

type File struct {
	FSO
}

File represents KBFS files.

func (File) CanDeleteDirectory 

func (t File) CanDeleteDirectory(ctx context.Context, fi *dokan.FileInfo) error

func (*File) CanDeleteFile 

func (f *File) CanDeleteFile(ctx context.Context, fi *dokan.FileInfo) error

CanDeleteFile - return just nil TODO check for permissions here.

func (*File) Cleanup 

func (f *File) Cleanup(ctx context.Context, fi *dokan.FileInfo)

Cleanup - for dokan, remember to handle deletions. If Cleanup is called with non-nil FileInfo that has IsDeleteOnClose() no libdokan locks should be held prior to the call.

func (File) CloseFile 

func (t File) CloseFile(ctx context.Context, fi *dokan.FileInfo)

func (File) FindFiles 

func (t File) FindFiles(ctx context.Context, fi *dokan.FileInfo, ignored string, cb func(*dokan.NamedStat) error) error

func (*File) FlushFileBuffers 

func (f *File) FlushFileBuffers(ctx context.Context, fi *dokan.FileInfo) (err error)

FlushFileBuffers performs a (f)sync.

func (*File) GetFileInformation 

func (f *File) GetFileInformation(ctx context.Context, fi *dokan.FileInfo) (a *dokan.Stat, err error)

GetFileInformation for dokan.

func (File) GetFileSecurity 

func (t File) GetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (File) LockFile 

func (t File) LockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (*File) ReadFile 

func (f *File) ReadFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (n int, err error)

ReadFile for dokan reads.

func (*File) SetAllocationSize 

func (f *File) SetAllocationSize(ctx context.Context, fi *dokan.FileInfo, newSize int64) (err error)

SetAllocationSize for dokan (f)truncates but does not grow file size (it may fallocate, but that is not done at the moment).

func (*File) SetEndOfFile 

func (f *File) SetEndOfFile(ctx context.Context, fi *dokan.FileInfo, length int64) (err error)

SetEndOfFile for dokan (f)truncates.

func (*File) SetFileAttributes 

func (f *File) SetFileAttributes(ctx context.Context, fi *dokan.FileInfo, fileAttributes dokan.FileAttribute) error

SetFileAttributes for Dokan.

func (File) SetFileSecurity 

func (t File) SetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (File) UnlockFile 

func (t File) UnlockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (*File) WriteFile 

func (f *File) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (n int, err error)

WriteFile for dokan writes.

type Folder 

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

Folder represents KBFS top-level folders

func (*Folder) BatchChanges 

func (f *Folder) BatchChanges(
	ctx context.Context, changes []libkbfs.NodeChange, _ []libkbfs.NodeID)

BatchChanges is called for changes originating anywhere, including other hosts.

func (*Folder) LocalChange 

func (f *Folder) LocalChange(ctx context.Context, node libkbfs.Node, write libkbfs.WriteRange)

LocalChange is called for changes originating within in this process.

func (*Folder) TlfHandleChange 

func (f *Folder) TlfHandleChange(ctx context.Context,
	newHandle *tlfhandle.Handle)

TlfHandleChange is called when the name of a folder changes. Note that newHandle may be nil. Then the handle in the folder is used. This is used on e.g. logout/login.

type FolderList 

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

FolderList is a node that can list all of the logged-in user's favorite top-level folders, on either a public or private basis.

func (FolderList) CanDeleteDirectory 

func (t FolderList) CanDeleteDirectory(ctx context.Context, fi *dokan.FileInfo) error

func (FolderList) CanDeleteFile 

func (t FolderList) CanDeleteFile(ctx context.Context, fi *dokan.FileInfo) error

func (FolderList) Cleanup 

func (t FolderList) Cleanup(ctx context.Context, fi *dokan.FileInfo)

func (FolderList) CloseFile 

func (t FolderList) CloseFile(ctx context.Context, fi *dokan.FileInfo)

func (*FolderList) FindFiles 

func (fl *FolderList) FindFiles(ctx context.Context, fi *dokan.FileInfo, ignored string, callback func(*dokan.NamedStat) error) (err error)

FindFiles for dokan.

func (FolderList) FlushFileBuffers 

func (t FolderList) FlushFileBuffers(ctx context.Context, fi *dokan.FileInfo) error

func (*FolderList) GetFileInformation 

func (*FolderList) GetFileInformation(context.Context, *dokan.FileInfo) (*dokan.Stat, error)

GetFileInformation for dokan.

func (FolderList) GetFileSecurity 

func (t FolderList) GetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (FolderList) LockFile 

func (t FolderList) LockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (FolderList) ReadFile 

func (t FolderList) ReadFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

func (FolderList) SetAllocationSize 

func (t FolderList) SetAllocationSize(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (FolderList) SetEndOfFile 

func (t FolderList) SetEndOfFile(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (FolderList) SetFileAttributes 

func (t FolderList) SetFileAttributes(ctx context.Context, fi *dokan.FileInfo, fileAttributes dokan.FileAttribute) error

func (FolderList) SetFileSecurity 

func (t FolderList) SetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (FolderList) SetFileTime 

func (t FolderList) SetFileTime(context.Context, *dokan.FileInfo, time.Time, time.Time, time.Time) error

func (FolderList) UnlockFile 

func (t FolderList) UnlockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (FolderList) WriteFile 

func (t FolderList) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

type JournalControlFile 

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

JournalControlFile is a special file used to control journal settings.

func (*JournalControlFile) GetFileInformation 

func (f *JournalControlFile) GetFileInformation(context.Context, *dokan.FileInfo) (*dokan.Stat, error)

func (*JournalControlFile) WriteFile 

func (f *JournalControlFile) WriteFile(ctx context.Context,
	fi *dokan.FileInfo, bs []byte, offset int64) (n int, err error)

WriteFile implements writes for dokan.

type PrefetchFile 

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

PrefetchFile represents a write-only file where any write of at least one byte triggers either disabling or enabling prefetching. It is mainly useful for testing.

func (*PrefetchFile) GetFileInformation 

func (f *PrefetchFile) GetFileInformation(context.Context, *dokan.FileInfo) (*dokan.Stat, error)

func (*PrefetchFile) WriteFile 

func (f *PrefetchFile) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (n int, err error)

WriteFile performs writes for dokan.

type ProfileList 

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

ProfileList is a node that can list all of the available profiles.

func (ProfileList) CanDeleteDirectory 

func (t ProfileList) CanDeleteDirectory(ctx context.Context, fi *dokan.FileInfo) error

func (ProfileList) CanDeleteFile 

func (t ProfileList) CanDeleteFile(ctx context.Context, fi *dokan.FileInfo) error

func (ProfileList) Cleanup 

func (t ProfileList) Cleanup(ctx context.Context, fi *dokan.FileInfo)

func (ProfileList) CloseFile 

func (t ProfileList) CloseFile(ctx context.Context, fi *dokan.FileInfo)

func (ProfileList) FindFiles 

func (ProfileList) FindFiles(ctx context.Context, fi *dokan.FileInfo, ignored string, callback func(*dokan.NamedStat) error) (err error)

FindFiles does readdir for dokan.

func (ProfileList) FlushFileBuffers 

func (t ProfileList) FlushFileBuffers(ctx context.Context, fi *dokan.FileInfo) error

func (ProfileList) GetFileInformation 

func (ProfileList) GetFileInformation(ctx context.Context, fi *dokan.FileInfo) (st *dokan.Stat, err error)

GetFileInformation for dokan.

func (ProfileList) GetFileSecurity 

func (t ProfileList) GetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (ProfileList) LockFile 

func (t ProfileList) LockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (ProfileList) ReadFile 

func (t ProfileList) ReadFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

func (ProfileList) SetAllocationSize 

func (t ProfileList) SetAllocationSize(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (ProfileList) SetEndOfFile 

func (t ProfileList) SetEndOfFile(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (ProfileList) SetFileAttributes 

func (t ProfileList) SetFileAttributes(ctx context.Context, fi *dokan.FileInfo, fileAttributes dokan.FileAttribute) error

func (ProfileList) SetFileSecurity 

func (t ProfileList) SetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (ProfileList) SetFileTime 

func (t ProfileList) SetFileTime(context.Context, *dokan.FileInfo, time.Time, time.Time, time.Time) error

func (ProfileList) UnlockFile 

func (t ProfileList) UnlockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (ProfileList) WriteFile 

func (t ProfileList) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

type ReclaimQuotaFile 

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

ReclaimQuotaFile represents a write-only file when any write of at least one byte triggers a quota reclamation of the folder.

func (*ReclaimQuotaFile) GetFileInformation 

func (f *ReclaimQuotaFile) GetFileInformation(context.Context, *dokan.FileInfo) (*dokan.Stat, error)

func (*ReclaimQuotaFile) WriteFile 

func (f *ReclaimQuotaFile) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (n int, err error)

WriteFile implements writes for dokan. Note a write triggers quota reclamation, but does not wait for it to finish. If you want to wait, write to SyncFromServerFileName.

type RekeyFile 

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

RekeyFile represents a write-only file when any write of at least one byte triggers a rekey of the folder.

func (*RekeyFile) GetFileInformation 

func (f *RekeyFile) GetFileInformation(context.Context, *dokan.FileInfo) (*dokan.Stat, error)

func (*RekeyFile) WriteFile 

func (f *RekeyFile) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (n int, err error)

WriteFile implements writes for dokan.

type ResetCachesFile 

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

ResetCachesFile represents a write-only file where any write of at least one byte triggers the resetting of all data caches. It can only be reached from the top-level FS mount. Note that it does not clear the *node* cache, which means that the BlockPointers for existing nodes are still cached, such that directory listings can still be implicitly cached for nodes still being held by callers.

func (*ResetCachesFile) GetFileInformation 

func (f *ResetCachesFile) GetFileInformation(context.Context, *dokan.FileInfo) (*dokan.Stat, error)

func (*ResetCachesFile) WriteFile 

func (f *ResetCachesFile) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (n int, err error)

WriteFile implements writes for dokan.

type Root 

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

Root represents the root of the KBFS file system.

func (Root) CanDeleteDirectory 

func (t Root) CanDeleteDirectory(ctx context.Context, fi *dokan.FileInfo) error

func (Root) CanDeleteFile 

func (t Root) CanDeleteFile(ctx context.Context, fi *dokan.FileInfo) error

func (Root) Cleanup 

func (t Root) Cleanup(ctx context.Context, fi *dokan.FileInfo)

func (Root) CloseFile 

func (t Root) CloseFile(ctx context.Context, fi *dokan.FileInfo)

func (*Root) FindFiles 

func (r *Root) FindFiles(ctx context.Context, fi *dokan.FileInfo, ignored string, callback func(*dokan.NamedStat) error) error

FindFiles for dokan readdir.

func (Root) FlushFileBuffers 

func (t Root) FlushFileBuffers(ctx context.Context, fi *dokan.FileInfo) error

func (*Root) GetFileInformation 

func (r *Root) GetFileInformation(ctx context.Context, fi *dokan.FileInfo) (*dokan.Stat, error)

GetFileInformation for dokan stats.

func (Root) GetFileSecurity 

func (t Root) GetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (Root) LockFile 

func (t Root) LockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (Root) ReadFile 

func (t Root) ReadFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

func (Root) SetAllocationSize 

func (t Root) SetAllocationSize(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (Root) SetEndOfFile 

func (t Root) SetEndOfFile(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (Root) SetFileAttributes 

func (t Root) SetFileAttributes(ctx context.Context, fi *dokan.FileInfo, fileAttributes dokan.FileAttribute) error

func (Root) SetFileSecurity 

func (t Root) SetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (Root) SetFileTime 

func (t Root) SetFileTime(context.Context, *dokan.FileInfo, time.Time, time.Time, time.Time) error

func (Root) UnlockFile 

func (t Root) UnlockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (Root) WriteFile 

func (t Root) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

type SpecialReadFile 

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

SpecialReadFile represents a file whose contents are determined by a function.

func NewArchiveRelTimeFile 

func NewArchiveRelTimeFile(
	fs *FS, handle *tlfhandle.Handle, filename string) *SpecialReadFile

NewArchiveRelTimeFile returns a special read file that contains a by-revision directory name that corresponds to the given relative time string for the given folder.

func NewErrorFile 

func NewErrorFile(fs *FS) *SpecialReadFile

NewErrorFile returns a special read file that contains a text representation of the last few KBFS errors.

func NewFileInfoFile 

func NewFileInfoFile(
	fs *FS, dir libkbfs.Node, name string) *SpecialReadFile

NewFileInfoFile returns a special file that contains a text representation of a file's KBFS metadata.

func NewMetricsFile 

func NewMetricsFile(fs *FS) *SpecialReadFile

NewMetricsFile returns a special read file that contains a text representation of all metrics.

func NewNonTLFStatusFile 

func NewNonTLFStatusFile(fs *FS) *SpecialReadFile

NewNonTLFStatusFile returns a special read file that contains a text representation of the global KBFS status.

func NewTlfEditHistoryFile 

func NewTlfEditHistoryFile(folder *Folder) *SpecialReadFile

NewTlfEditHistoryFile returns a special read file that contains a text representation of the file edit history for that TLF.

func NewUserEditHistoryFile 

func NewUserEditHistoryFile(folder *Folder) *SpecialReadFile

NewUserEditHistoryFile returns a special read file that contains a text representation of the file edit history for the logged-in user.

func (SpecialReadFile) CanDeleteDirectory 

func (t SpecialReadFile) CanDeleteDirectory(ctx context.Context, fi *dokan.FileInfo) error

func (SpecialReadFile) CanDeleteFile 

func (t SpecialReadFile) CanDeleteFile(ctx context.Context, fi *dokan.FileInfo) error

func (SpecialReadFile) Cleanup 

func (t SpecialReadFile) Cleanup(ctx context.Context, fi *dokan.FileInfo)

func (SpecialReadFile) CloseFile 

func (t SpecialReadFile) CloseFile(ctx context.Context, fi *dokan.FileInfo)

func (SpecialReadFile) FindFiles 

func (t SpecialReadFile) FindFiles(ctx context.Context, fi *dokan.FileInfo, ignored string, cb func(*dokan.NamedStat) error) error

func (SpecialReadFile) FlushFileBuffers 

func (t SpecialReadFile) FlushFileBuffers(ctx context.Context, fi *dokan.FileInfo) error

func (*SpecialReadFile) GetFileInformation 

func (f *SpecialReadFile) GetFileInformation(ctx context.Context, fi *dokan.FileInfo) (*dokan.Stat, error)

GetFileInformation does stats for dokan.

func (SpecialReadFile) GetFileSecurity 

func (t SpecialReadFile) GetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (SpecialReadFile) LockFile 

func (t SpecialReadFile) LockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (*SpecialReadFile) ReadFile 

func (f *SpecialReadFile) ReadFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

ReadFile does reads for dokan.

func (SpecialReadFile) SetAllocationSize 

func (t SpecialReadFile) SetAllocationSize(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (SpecialReadFile) SetEndOfFile 

func (t SpecialReadFile) SetEndOfFile(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (SpecialReadFile) SetFileAttributes 

func (t SpecialReadFile) SetFileAttributes(ctx context.Context, fi *dokan.FileInfo, fileAttributes dokan.FileAttribute) error

func (SpecialReadFile) SetFileSecurity 

func (t SpecialReadFile) SetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (SpecialReadFile) SetFileTime 

func (t SpecialReadFile) SetFileTime(context.Context, *dokan.FileInfo, time.Time, time.Time, time.Time) error

func (SpecialReadFile) UnlockFile 

func (t SpecialReadFile) UnlockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (SpecialReadFile) WriteFile 

func (t SpecialReadFile) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

type StartOptions 

type StartOptions struct {
	KbfsParams  libkbfs.InitParams
	RuntimeDir  string
	Label       string
	DokanConfig dokan.Config
	ForceMount  bool
	SkipMount   bool
	MountPoint  string
}

StartOptions are options for starting up 

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

Symlink represents KBFS symlinks.

func (Symlink) CanDeleteDirectory 

func (t Symlink) CanDeleteDirectory(ctx context.Context, fi *dokan.FileInfo) error

func (Symlink) CanDeleteFile 

func (t Symlink) CanDeleteFile(ctx context.Context, fi *dokan.FileInfo) error

func (Symlink) Cleanup 

func (t Symlink) Cleanup(ctx context.Context, fi *dokan.FileInfo)

func (Symlink) CloseFile 

func (t Symlink) CloseFile(ctx context.Context, fi *dokan.FileInfo)

func (Symlink) FindFiles 

func (t Symlink) FindFiles(ctx context.Context, fi *dokan.FileInfo, ignored string, cb func(*dokan.NamedStat) error) error

func (Symlink) FlushFileBuffers 

func (t Symlink) FlushFileBuffers(ctx context.Context, fi *dokan.FileInfo) error

func (*Symlink) GetFileInformation 

func (s *Symlink) GetFileInformation(ctx context.Context, fi *dokan.FileInfo) (a *dokan.Stat, err error)

GetFileInformation does stat for dokan.

func (Symlink) GetFileSecurity 

func (t Symlink) GetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (Symlink) LockFile 

func (t Symlink) LockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (Symlink) ReadFile 

func (t Symlink) ReadFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

func (Symlink) SetAllocationSize 

func (t Symlink) SetAllocationSize(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (Symlink) SetEndOfFile 

func (t Symlink) SetEndOfFile(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (Symlink) SetFileAttributes 

func (t Symlink) SetFileAttributes(ctx context.Context, fi *dokan.FileInfo, fileAttributes dokan.FileAttribute) error

func (Symlink) SetFileSecurity 

func (t Symlink) SetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (Symlink) SetFileTime 

func (t Symlink) SetFileTime(context.Context, *dokan.FileInfo, time.Time, time.Time, time.Time) error

func (Symlink) UnlockFile 

func (t Symlink) UnlockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (Symlink) WriteFile 

func (t Symlink) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

type SyncControlFile 

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

SyncControlFile is a special file used to control sync settings.

func (*SyncControlFile) GetFileInformation 

func (f *SyncControlFile) GetFileInformation(context.Context, *dokan.FileInfo) (*dokan.Stat, error)

func (*SyncControlFile) WriteFile 

func (f *SyncControlFile) WriteFile(ctx context.Context,
	fi *dokan.FileInfo, bs []byte, offset int64) (n int, err error)

WriteFile implements writes for dokan.

type SyncFromServerFile 

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

SyncFromServerFile represents a write-only file when any write of at least one byte triggers a sync of the folder from the server. A sync:

  • Waits for any outstanding conflict resolution tasks to finish (and it fails if the TLF is still in staged mode after waiting for CR).
  • Checks with the server for what the latest revision is for the folder.
  • Fetches and applies any missing revisions.
  • Waits for all outstanding block archive tasks to complete.
  • Waits for all outstanding quota reclamation tasks to complete.

func (*SyncFromServerFile) GetFileInformation 

func (f *SyncFromServerFile) GetFileInformation(context.Context, *dokan.FileInfo) (*dokan.Stat, error)

func (*SyncFromServerFile) WriteFile 

func (f *SyncFromServerFile) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (n int, err error)

WriteFile implements writes for dokan.

type TLF 

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

TLF represents the root directory of a TLF. It wraps a lazy-loaded Dir.

func (*TLF) CanDeleteDirectory 

func (tlf *TLF) CanDeleteDirectory(ctx context.Context, fi *dokan.FileInfo) (err error)

CanDeleteDirectory - return just nil because tlfs can always be removed from favorites.

func (TLF) CanDeleteFile 

func (t TLF) CanDeleteFile(ctx context.Context, fi *dokan.FileInfo) error

func (*TLF) Cleanup 

func (tlf *TLF) Cleanup(ctx context.Context, fi *dokan.FileInfo)

Cleanup - forget references, perform deletions etc.

func (TLF) CloseFile 

func (t TLF) CloseFile(ctx context.Context, fi *dokan.FileInfo)

func (*TLF) FindFiles 

func (tlf *TLF) FindFiles(ctx context.Context, fi *dokan.FileInfo, pattern string, callback func(*dokan.NamedStat) error) (err error)

FindFiles does readdir for dokan.

func (TLF) FlushFileBuffers 

func (t TLF) FlushFileBuffers(ctx context.Context, fi *dokan.FileInfo) error

func (*TLF) GetFileInformation 

func (tlf *TLF) GetFileInformation(ctx context.Context, fi *dokan.FileInfo) (st *dokan.Stat, err error)

GetFileInformation for dokan.

func (TLF) GetFileSecurity 

func (t TLF) GetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (TLF) LockFile 

func (t TLF) LockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (TLF) ReadFile 

func (t TLF) ReadFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

func (TLF) SetAllocationSize 

func (t TLF) SetAllocationSize(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (TLF) SetEndOfFile 

func (t TLF) SetEndOfFile(ctx context.Context, fi *dokan.FileInfo, length int64) error

func (*TLF) SetFileAttributes 

func (tlf *TLF) SetFileAttributes(ctx context.Context, fi *dokan.FileInfo, fileAttributes dokan.FileAttribute) error

SetFileAttributes for Dokan.

func (TLF) SetFileSecurity 

func (t TLF) SetFileSecurity(ctx context.Context, fi *dokan.FileInfo, si winacl.SecurityInformation, sd *winacl.SecurityDescriptor) error

func (*TLF) SetFileTime 

func (tlf *TLF) SetFileTime(ctx context.Context, fi *dokan.FileInfo, creation time.Time, lastAccess time.Time, lastWrite time.Time) (err error)

SetFileTime sets mtime for FSOs (File and Dir).

func (TLF) UnlockFile 

func (t TLF) UnlockFile(ctx context.Context, fi *dokan.FileInfo, offset int64, length int64) error

func (TLF) WriteFile 

func (t TLF) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (int, error)

type UnstageFile 

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

UnstageFile represents a write-only file when any write of at least one byte triggers unstaging all unmerged commits and fast-forwarding to the current master.

func (*UnstageFile) GetFileInformation 

func (f *UnstageFile) GetFileInformation(context.Context, *dokan.FileInfo) (*dokan.Stat, error)

func (*UnstageFile) WriteFile 

func (f *UnstageFile) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (n int, err error)

WriteFile implements writes for dokan.

type UpdatesFile 

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

UpdatesFile represents a write-only file where any write of at least one byte triggers either disabling remote folder updates and conflict resolution, or re-enabling both. It is mainly useful for testing.

func (*UpdatesFile) GetFileInformation 

func (f *UpdatesFile) GetFileInformation(context.Context, *dokan.FileInfo) (*dokan.Stat, error)

func (*UpdatesFile) WriteFile 

func (f *UpdatesFile) WriteFile(ctx context.Context, fi *dokan.FileInfo, bs []byte, offset int64) (n int, err error)

WriteFile performs writes for dokan.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.