NAME

ELF::Extract::Sections::Scanner::Objdump - An objdump based section scanner.

VERSION

version 0.03000101

SYNOPSIS

This module is a model implementation of a Naive and system reliant ELF Section detector. Its currently highly inefficient due to having to run the entire ELF through a disassembly process to determine the section positions and only guesses at section lengths by advertising that it can't compute sizes.

TO use this module, simply initialise ELF::Extract::Sections as so

    my $extractor  = ELF::Extract::Sections->new(
            file => "/path/to/file.so" ,
            scanner => "Objdump",
    );

IMPLEMENTS ROLES

ELF::Extract::Sections::Meta::Scanner

ELF::Extract::Sections::Meta::Scanner

DEPENDS

MooseX::Has::Sugar

Lots of keywords.

MooseX::Has::Sugar

MooseX::Types::Moose

Type Constraining Keywords.

MooseX::Types::Moose

MooseX::Types::Path::Tiny

File Type Constraints w/ Path::Tiny

MooseX::Types::Path::Tiny

PUBLIC METHODS

-> open_file ( file => File ) : Bool ::Scanner

Opens the file and assigns our state to that file.

"open_file" in ELF::Extract::Sections::Meta::Scanner

-> next_section () : Bool ::Scanner

Advances our state to the next section.

"next_section" in ELF::Extract::Sections::Meta::Scanner

-> section_offset () : Int | Undef ::Scanner

Reports the offset of the currently open section

"section_offset" in ELF::Extract::Sections::Meta::Scanner

-> section_size () : Undef ::Scanner

Dies, because this module can't compute section sizes.

"section_size" in ELF::Extract::Sections::Meta::Scanner

-> section_name () : Str | Undef ::Scanner

Returns the name of the current section

"section_name" in ELF::Extract::Sections::Meta::Scanner

-> can_compute_size () : Bool ::Scanner

Returns false

"can_compute_size" in ELF::Extract::Sections::Meta::Scanner

PRIVATE ATTRIBUTES

_header_regex : RegexpRef

A regular expression for identifying the

  <asdasdead>

Style tokens that denote objdump header names.

Note: This is not XML.

_offset_regex : RegexpRef

A regular expression for identifying offset blocks in objdump's output.

They look like this:

  File Offset: 0xdeadbeef

_section_header_identifier : RegexpRef

A regular expression for extracting Headers and Offsets together

  <headername> File Offset: 0xdeadbeef

_file : File

A Path::Tiny reference to a file somewhere on a system

_clear_file : _file.clearer

Clears "_file"

_filehandle : FileHandle

A perl FileHandle that points to the output of objdump for "_file"

_clear_file_handle : _filehandle.clearer

Clears "_filehandle"

_state : HashRef

Keeps track of what we're doing, and what the next header is to return.

_has_state : _state.predicate

Returns is-set of "_state"

_clear_state : _state.clearer

Clears _state

PRIVATE ATTRIBUTE BUILDERS

-> _build__section_header_identifier : RegexpRef

Assembles "_header_regex" and "_offset_regex"

"_section_header_identifier"

PRIVATE METHODS

-> _objdump : FileHandle | Undef

Calls the system objdump instance for the currently processing file.

AUTHOR

Kent Fredric <kentnl@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Kent Fredric.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm ELF::Extract::Sections

perl -MCPAN -e shell
install ELF::Extract::Sections