unixfs

Documentation

Overview

Package format implements a data format for files in the IPFS filesystem It is not the only format in ipfs, but it is the one that the filesystem assumes

Index

• Constants
• Variables
• func BytesForMetadata(m *Metadata) ([]byte, error)
• func DataSize(data []byte) (uint64, error)
• func EmptyDirNode() *dag.ProtoNode
• func FilePBData(data []byte, totalsize uint64) []byte
• func FolderPBData() []byte
• func FromBytes(data []byte) (*pb.Data, error)
• func SymlinkData(path string) ([]byte, error)
• func UnwrapData(data []byte) ([]byte, error)
• func WrapData(b []byte) []byte
• type FSNode
  • func FSNodeFromBytes(b []byte) (*FSNode, error)
  • func (n *FSNode) AddBlockSize(s uint64)
  • func (n *FSNode) FileSize() uint64
  • func (n *FSNode) GetBytes() ([]byte, error)
  • func (n *FSNode) NumChildren() int
  • func (n *FSNode) RemoveBlockSize(i int)
• type Metadata
  • func MetadataFromBytes(b []byte) (*Metadata, error)
  • func (m *Metadata) Bytes() ([]byte, error)

Constants

const (
	TRaw       = pb.Data_Raw
	TFile      = pb.Data_File
	TDirectory = pb.Data_Directory
	TMetadata  = pb.Data_Metadata
	TSymlink   = pb.Data_Symlink
	THAMTShard = pb.Data_HAMTShard
)

Variables

var ErrInvalidDirLocation = errors.New("found directory node in unexpected place")

var ErrMalformedFileFormat = errors.New("malformed data in file format")

var ErrUnrecognizedType = errors.New("unrecognized node type")

Functions

func BytesForMetadata

func BytesForMetadata(m *Metadata) ([]byte, error)

func DataSize

func DataSize(data []byte) (uint64, error)

func EmptyDirNode

func EmptyDirNode() *dag.ProtoNode

func FilePBData

func FilePBData(data []byte, totalsize uint64) []byte

func FolderPBData

func FolderPBData() []byte

FolderPBData returns Bytes that represent a Directory.

func FromBytes

func FromBytes(data []byte) (*pb.Data, error)

func SymlinkData

func SymlinkData(path string) ([]byte, error)

SymlinkData returns a `Data_Symlink` protobuf message for the path you specify.

func UnwrapData

func UnwrapData(data []byte) ([]byte, error)

func WrapData

func WrapData(b []byte) []byte

WrapData marshals raw bytes into a `Data_Raw` type protobuf message.

Types

type FSNode

type FSNode struct {
	Data []byte

	// node type of this node
	Type pb.Data_DataType
	// contains filtered or unexported fields
}

func FSNodeFromBytes

func FSNodeFromBytes(b []byte) (*FSNode, error)

func (*FSNode) AddBlockSize

func (n *FSNode) AddBlockSize(s uint64)

AddBlockSize adds the size of the next child block of this node

func (*FSNode) FileSize

func (n *FSNode) FileSize() uint64

func (*FSNode) GetBytes

func (n *FSNode) GetBytes() ([]byte, error)

func (*FSNode) NumChildren

func (n *FSNode) NumChildren() int

func (*FSNode) RemoveBlockSize

func (n *FSNode) RemoveBlockSize(i int)

type Metadata

type Metadata struct {
	MimeType string
	Size     uint64
}

func MetadataFromBytes

func MetadataFromBytes(b []byte) (*Metadata, error)

MetadataFromBytes Unmarshals a protobuf message into Metadata.

func (*Metadata) Bytes

func (m *Metadata) Bytes() ([]byte, error)