Class: RPM::File::Header

Inherits:
Object
  • Object
show all
Includes:
Cabin::Inspectable
Defined in:
lib/rpm/file/header.rb

Constant Summary

HEADER_SIGNED_TYPE =
5
HEADER_MAGIC =
"\x8e\xad\xe8\x01\x00\x00\x00\x00"
HEADER_HEADER_LENGTH =

magic + index_count + data_length

HEADER_MAGIC.length + 4 + 4
TAG_ENTRY_SIZE =

tag id, type, offset, count == 16 bytes

16

Instance Attribute Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (Header) initialize(file)

Returns a new instance of Header



20
21
22
23
24
25
# File 'lib/rpm/file/header.rb', line 20

def initialize(file)
  @file = file

  @inspectables = [:@length, :@index_count, :@data_length]
  @tags = []
end

Instance Attribute Details

- (Object) data_length

rpmlib calls this field 'il' unhelpfully rpmlib calls this field 'dl' unhelpfully



12
13
14
# File 'lib/rpm/file/header.rb', line 12

def data_length
  @data_length
end

- (Object) index_count

Returns the value of attribute index_count



11
12
13
# File 'lib/rpm/file/header.rb', line 11

def index_count
  @index_count
end

- (Object) length (readonly)

Returns the value of attribute length



8
9
10
# File 'lib/rpm/file/header.rb', line 8

def length
  @length
end

- (Object) magic

8-byte string magic



10
11
12
# File 'lib/rpm/file/header.rb', line 10

def magic
  @magic
end

- (Object) tags (readonly)

Returns the value of attribute tags



7
8
9
# File 'lib/rpm/file/header.rb', line 7

def tags
  @tags
end

Instance Method Details

- (Object) read



27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
# File 'lib/rpm/file/header.rb', line 27

def read
  # TODO(sissel): update the comments here to reflect learnings about rpm
  # internals
  # At this point assume we've read and consumed the lead and signature.
  #len = @rpm.signature.index_length + @rpm.signature
  #
  # header size is
  #     ( @rpm.signature.index_length * size of a header entry )
  #     + @rpm.signature.data_length
  #
  # header 'entries' are an
  #   int32 (tag id), int32 (tag type), int32  (offset), uint32 (count)
  #
  #       len = sizeof(il) + sizeof(dl) + (il * sizeof(struct entryInfo_s)) + dl;
  # See rpm's header.c, the headerLoad method function for reference.

  # Header always starts with HEADER_MAGIC + index_count(2bytes) +
  # data_length(2bytes)
  data = @file.read(HEADER_HEADER_LENGTH).unpack("a8NN")
  # TODO(sissel): @index_count is really a count, rename?
  @magic, @index_count, @data_length = data
  validate
  
  @index_size = @index_count * TAG_ENTRY_SIZE
  tag_data = @file.read(@index_size)
  data = @file.read(@data_length)

  (0 ... @index_count).each do |i|
    offset = i * TAG_ENTRY_SIZE
    entry_data = tag_data[i * TAG_ENTRY_SIZE, TAG_ENTRY_SIZE]
    entry = entry_data.unpack("NNNN")
    entry << data
    tag = ::RPM::File::Tag.new(*entry)
    @tags << tag
  end # each index

  @length = HEADER_HEADER_LENGTH + @index_size + @data_length
end

- (Object) validate

def write



73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
# File 'lib/rpm/file/header.rb', line 73

def validate
  # TODO(sissel): raise real exceptions
  if @magic != ::RPM::File::Header::HEADER_MAGIC
    raise "Header magic did not match; got #{@magic.inspect}, " \
          "expected #{::RPM::File::Header::HEADER_MAGIC.inspect}"
  end

  #if !(0..32).include?(@index_count)
    #raise "Invalid 'index_count' value #{@index_count}, expected to be in range [0..32]"
  #end

  #if !(0..8192).include?(@data_length)
    #raise "Invalid 'data_length' value #{@data_length}, expected to be in range [0..8192]"
  #end
end

- (Object) write

def read



66
67
68
69
70
71
# File 'lib/rpm/file/header.rb', line 66

def write
  raise "not implemented yet"
  # Sort tags by type (integer value)
  # emit all tags in order
  # then emit all data segments in same order
end