spath

Documentation

Index

• Constants
• type HopField
  • func HopFFromRaw(b []byte) (*HopField, error)
  • func NewHopField(b common.RawBytes, in common.IFIDType, out common.IFIDType) *HopField
  • func (h *HopField) CalcMac(mac hash.Hash, tsInt uint32, prev common.RawBytes) (common.RawBytes, error)
  • func (h *HopField) Len() int
  • func (h *HopField) String() string
  • func (h *HopField) Verify(mac hash.Hash, tsInt uint32, prev common.RawBytes) error
  • func (h *HopField) Write()
  • func (h *HopField) WriteTo(w io.Writer) (int64, error)
• type InfoField
  • func InfoFFromRaw(b []byte) (*InfoField, error)
  • func (inf *InfoField) String() string
  • func (inf *InfoField) Timestamp() time.Time
  • func (inf *InfoField) Write(b common.RawBytes)
  • func (inf *InfoField) WriteTo(w io.Writer) (int64, error)
• type Path
  • func New(raw common.RawBytes) *Path
  • func (p *Path) Copy() *Path
  • func (path *Path) GetHopField(offset int) (*HopField, error)
  • func (path *Path) GetInfoField(offset int) (*InfoField, error)
  • func (path *Path) IncOffsets() error
  • func (path *Path) InitOffsets() error
  • func (p *Path) Reverse() error

Constants

const (
	HopFieldLength    = common.LineLen
	DefaultHopFExpiry = 63
	MacLen            = 3
	ErrorHopFTooShort = "HopF too short"
	ErrorHopFBadMac   = "Bad HopF MAC"
	XoverMask         = 0x01
	VerifyOnlyMask    = 0x02
	RecurseMask       = 0x04
)

const (
	InfoFieldLength    = common.LineLen
	ErrorInfoFTooShort = "InfoF too short"
)

const (
	MaxTTL      = 24 * 60 * 60 // One day in seconds
	ExpTimeUnit = MaxTTL / (1 << 8)

	MaxTimestamp = ^uint32(0)
)

Types

type HopField

type HopField struct {
	Xover       bool
	VerifyOnly  bool
	Recurse     bool
	ExpTime     uint8
	ConsIngress common.IFIDType
	ConsEgress  common.IFIDType
	Mac         common.RawBytes
	// contains filtered or unexported fields
}

func HopFFromRaw

func HopFFromRaw(b []byte) (*HopField, error)

HopFFromRaw returns a HopField object from the raw content in b.

The new HopField object takes ownership of the first HopFieldLength bytes in b. Changing fields in the new object and calling Write will mutate the initial bytes in b.

func NewHopField

func NewHopField(b common.RawBytes, in common.IFIDType, out common.IFIDType) *HopField

func (*HopField) CalcMac

func (h *HopField) CalcMac(mac hash.Hash, tsInt uint32,
	prev common.RawBytes) (common.RawBytes, error)

CalcMac calculates the MAC of a Hop Field and its preceeding Hop Field, if any.

func (*HopField) Len

func (h *HopField) Len() int

Len returns the length (in bytes)

func (*HopField) String

func (h *HopField) String() string

func (*HopField) Verify

func (h *HopField) Verify(mac hash.Hash, tsInt uint32, prev common.RawBytes) error

func (*HopField) Write

func (h *HopField) Write()

func (*HopField) WriteTo

func (h *HopField) WriteTo(w io.Writer) (int64, error)

WriteTo implements the io.WriterTo interface.

type InfoField

type InfoField struct {
	// Previously Up, ConsDir = !Up
	ConsDir  bool
	Shortcut bool
	Peer     bool
	TsInt    uint32
	ISD      uint16
	Hops     uint8
}

func InfoFFromRaw

func InfoFFromRaw(b []byte) (*InfoField, error)

func (*InfoField) String

func (inf *InfoField) String() string

func (*InfoField) Timestamp

func (inf *InfoField) Timestamp() time.Time

func (*InfoField) Write

func (inf *InfoField) Write(b common.RawBytes)

func (*InfoField) WriteTo

func (inf *InfoField) WriteTo(w io.Writer) (int64, error)

WriteTo implements the io.WriterTo interface.

type Path

type Path struct {
	Raw    common.RawBytes
	InfOff int // Offset of current Info Field
	HopOff int // Offset of current Hop Field
}

func New

func New(raw common.RawBytes) *Path

func (*Path) Copy

func (p *Path) Copy() *Path

func (*Path) GetHopField

func (path *Path) GetHopField(offset int) (*HopField, error)

func (*Path) GetInfoField

func (path *Path) GetInfoField(offset int) (*InfoField, error)

func (*Path) IncOffsets

func (path *Path) IncOffsets() error

IncOffsets updates the info and hop indices to the next routing field, while skipping verify only fields.

func (*Path) InitOffsets

func (path *Path) InitOffsets() error

InitOffsets computes the initial Hop Field offset (in bytes) for a newly created packet.

func (*Path) Reverse

func (p *Path) Reverse() error