eosclient

package
v3.5.0 Latest Latest
Warning

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

 Go to latest Published: Jan 9, 2026 License: Apache-2.0 Imports: 10 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	EndPosition   uint = 0
	StartPosition uint = 1
)

Constants for ACL position.

View Source 
const AttrAlreadyExistsError = errtypes.BadRequest("attr already exists")

AttrAlreadyExistsError is the error raised when setting an already existing attr on a resource.

View Source 
const AttrNotExistsError = errtypes.BadRequest("attr not exists")

AttrNotExistsError is the error raised when removing an attribute that does not exist.

View Source 
const EosAppHeader = "X-EOS-APP"

The corresponding header to pass the app "tag" to EOS

View Source 
const EosAppParam = "eos.app"

The URL query parameter to be used to pass the app "tag" to EOS

View Source 
const EosAppPrefix = "http/reva"

A prefix for the app "tag": note we use 'http/' as we interact via HTTP and EOS would anyway prefix our traffic as such: this is critical for apps locking to work correctly!

View Source 
const (
	FavoritesKey = "http://owncloud.org/ns/favorite"
)
View Source 
const FileIsLockedError = errtypes.BadRequest("file is locked")

FileIsLockedError is the error raised when attempting to set a lock attribute to an already locked file with a mismatched lock.

View Source 
const ProjectQuotaGID = "99"

ProjectQuotaGID is the special GID used for EOS project quotas.

Variables

This section is empty.

Functions

func AttrTypeToString 

func AttrTypeToString(at AttrType) string

AttrTypeToString converts a type to a string representation.

func GetFileFromVersionFolder 

func GetFileFromVersionFolder(p string) string

func GetVersionFolder 

func GetVersionFolder(p string) string

func IsVersionFolder 

func IsVersionFolder(p string) bool

Types

type AttrType 

type AttrType uint32

AttrType is the type of extended attribute, either system (sys) or user (user). 

const (
	// SystemAttr is the system extended attribute.
	SystemAttr AttrType = iota
	// UserAttr is the user extended attribute.
	UserAttr
)

func AttrStringToType 

func AttrStringToType(t string) (AttrType, error)

AttrStringToType converts a string to an AttrType.

type Attribute 

type Attribute struct {
	Type     AttrType
	Key, Val string
}

Attribute represents an EOS extended attribute.

func (*Attribute) GetKey 

func (a *Attribute) GetKey() string

GetKey returns the key considering the type of attribute.

type Authorization 

type Authorization struct {
	Role  Role
	Token string
}

Authorization specifies the mechanisms through which EOS can be accessed. One of the data members must be set.

type Checksum 

type Checksum struct {
	XSSum  string
	XSType string
}

Checksum represents a cheksum entry for a file returned by EOS.

type DeletedEntry 

type DeletedEntry struct {
	RestorePath   string
	RestoreKey    string
	Size          uint64
	DeletionMTime uint64
	IsDir         bool
}

DeletedEntry represents an entry from the trashbin.

type EOSClient 

type EOSClient interface {
	AddACL(ctx context.Context, auth, rootAuth Authorization, path string, position uint, a *acl.Entry) error
	RemoveACL(ctx context.Context, auth, rootAuth Authorization, path string, a *acl.Entry) error
	UpdateACL(ctx context.Context, auth, rootAuth Authorization, path string, position uint, a *acl.Entry) error
	GetACL(ctx context.Context, auth Authorization, path, aclType, target string) (*acl.Entry, error)
	ListACLs(ctx context.Context, auth Authorization, path string) ([]*acl.Entry, error)
	GetFileInfoByInode(ctx context.Context, auth Authorization, inode uint64) (*FileInfo, error)
	GetFileInfoByFXID(ctx context.Context, auth Authorization, fxid string) (*FileInfo, error)
	GetFileInfoByPath(ctx context.Context, auth Authorization, path string) (*FileInfo, error)
	SetAttr(ctx context.Context, auth Authorization, attr *Attribute, errorIfExists, recursive bool, path, app string) error
	UnsetAttr(ctx context.Context, auth Authorization, attr *Attribute, recursive bool, path, app string) error
	GetAttr(ctx context.Context, auth Authorization, key, path string) (*Attribute, error)
	GetAttrs(ctx context.Context, auth Authorization, path string) ([]*Attribute, error)
	GetQuota(ctx context.Context, user Authorization, rootAuth Authorization, path string) (*QuotaInfo, error)
	SetQuota(ctx context.Context, user Authorization, rootAuth Authorization, info *SetQuotaInfo) error
	Touch(ctx context.Context, auth Authorization, path string) error
	Chown(ctx context.Context, auth, chownauth Authorization, path string) error
	Chmod(ctx context.Context, auth Authorization, mode, path string) error
	CreateDir(ctx context.Context, auth Authorization, path string) error
	Remove(ctx context.Context, auth Authorization, path string, noRecycle bool) error
	Rename(ctx context.Context, auth Authorization, oldPath, newPath string) error
	List(ctx context.Context, auth Authorization, path string) ([]*FileInfo, error)
	ListWithRegex(ctx context.Context, auth Authorization, path string, depth uint, regex string) ([]*FileInfo, error)
	Read(ctx context.Context, auth Authorization, path string, ranges []storage.Range) (io.ReadCloser, error)
	Write(ctx context.Context, auth Authorization, path string, stream io.ReadCloser, length int64, app string, disableVersioning bool) error
	ListDeletedEntries(ctx context.Context, auth Authorization, maxentries int, from, to time.Time) ([]*DeletedEntry, error)
	RestoreDeletedEntry(ctx context.Context, auth Authorization, key string) error
	PurgeDeletedEntries(ctx context.Context, auth Authorization) error
	ListVersions(ctx context.Context, auth Authorization, p string) ([]*FileInfo, error)
	RollbackToVersion(ctx context.Context, auth Authorization, path, version string) error
	ReadVersion(ctx context.Context, auth Authorization, p, version string) (io.ReadCloser, error)
	GenerateToken(ctx context.Context, auth Authorization, path string, a *acl.Entry) (string, error)
}

EOSClient is the interface which enables access to EOS instances through various interfaces.

type FileInfo 

type FileInfo struct {
	IsDir      bool
	Inode      uint64            `json:"inode"`
	FID        uint64            `json:"fid"`
	UID        uint64            `json:"uid"`
	GID        uint64            `json:"gid"`
	TreeSize   uint64            `json:"tree_size"`
	MTimeSec   uint64            `json:"mtime_sec"`
	MTimeNanos uint32            `json:"mtime_nanos"`
	ATimeSec   uint64            `json:"atime_sec"`
	ATimeNanos uint32            `json:"atime_nanos"`
	CTimeSec   uint64            `json:"ctime_sec"`
	CTimeNanos uint32            `json:"ctime_nanos"`
	Size       uint64            `json:"size"`
	TreeCount  uint64            `json:"tree_count"`
	File       string            `json:"eos_file"`
	ETag       string            `json:"etag"`
	Instance   string            `json:"instance"`
	XS         *Checksum         `json:"xs"`
	SysACL     *acl.ACLs         `json:"sys_acl"`
	Attrs      map[string]string `json:"attrs"`
}

FileInfo represents the metadata information returned by querying the EOS namespace.

type QuotaInfo 

type QuotaInfo struct {
	TotalBytes, UsedBytes   uint64
	TotalInodes, UsedInodes uint64
}

QuotaInfo reports the total and used bytes and inodes for a particular user. eos reports all quota values are unsigned long, see https://github.com/cern-eos/eos/blob/93515df8c0d5a858982853d960bec98f983c1285/mgm/Quota.hh#L135

type Role 

type Role struct {
	UID, GID string
}

Role holds the attributes required to authenticate to EOS via role-based access.

type SetQuotaInfo 

type SetQuotaInfo struct {
	Username  string
	UID       string
	GID       string
	QuotaNode string
	MaxBytes  uint64
	MaxFiles  uint64
}

SetQuotaInfo encapsulates the information needed to create a quota space in EOS for a user.

Source Files

View all Source files

Directories

Path Synopsis

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.