diff options
| author | Craig Jennings <c@cjennings.net> | 2025-08-14 22:58:58 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2025-08-14 22:58:58 -0500 |
| commit | 82ba818ff456bcd6d56a06226e3f27e98fbb55c3 (patch) | |
| tree | 158cfc17b2f644a10f063cb546752cfaae12c97f /devdocs/go/debug%2Fplan9obj%2Findex.html | |
| parent | 9278ddd4ea1a8b1a4c1edaa8894516e3f48d245b (diff) | |
| download | dotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.tar.gz dotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.zip | |
removing all downloaded devdocs files
Diffstat (limited to 'devdocs/go/debug%2Fplan9obj%2Findex.html')
| -rw-r--r-- | devdocs/go/debug%2Fplan9obj%2Findex.html | 87 |
1 files changed, 0 insertions, 87 deletions
diff --git a/devdocs/go/debug%2Fplan9obj%2Findex.html b/devdocs/go/debug%2Fplan9obj%2Findex.html deleted file mode 100644 index d4abc113..00000000 --- a/devdocs/go/debug%2Fplan9obj%2Findex.html +++ /dev/null @@ -1,87 +0,0 @@ -<h1> Package plan9obj </h1> <ul id="short-nav"> -<li><code>import "debug/plan9obj"</code></li> -<li><a href="#pkg-overview" class="overviewLink">Overview</a></li> -<li><a href="#pkg-index" class="indexLink">Index</a></li> -</ul> <h2 id="pkg-overview">Overview </h2> <p>Package plan9obj implements access to Plan 9 a.out object files. </p> -<h3 id="hdr-Security">Security</h3> <p>This package is not designed to be hardened against adversarial inputs, and is outside the scope of <a href="https://go.dev/security/policy">https://go.dev/security/policy</a>. In particular, only basic validation is done when parsing object files. As such, care should be taken when parsing untrusted inputs, as parsing malformed files may consume significant resources, or cause panics. </p> <h2 id="pkg-index">Index </h2> <ul id="manual-nav"> -<li><a href="#pkg-constants">Constants</a></li> -<li><a href="#pkg-variables">Variables</a></li> -<li><a href="#File">type File</a></li> -<li> <a href="#NewFile">func NewFile(r io.ReaderAt) (*File, error)</a> -</li> -<li> <a href="#Open">func Open(name string) (*File, error)</a> -</li> -<li> <a href="#File.Close">func (f *File) Close() error</a> -</li> -<li> <a href="#File.Section">func (f *File) Section(name string) *Section</a> -</li> -<li> <a href="#File.Symbols">func (f *File) Symbols() ([]Sym, error)</a> -</li> -<li><a href="#FileHeader">type FileHeader</a></li> -<li><a href="#Section">type Section</a></li> -<li> <a href="#Section.Data">func (s *Section) Data() ([]byte, error)</a> -</li> -<li> <a href="#Section.Open">func (s *Section) Open() io.ReadSeeker</a> -</li> -<li><a href="#SectionHeader">type SectionHeader</a></li> -<li><a href="#Sym">type Sym</a></li> -</ul> <h3>Package files</h3> <p> <span>file.go</span> <span>plan9obj.go</span> </p> <h2 id="pkg-constants">Constants</h2> <pre data-language="go">const ( - Magic64 = 0x8000 // 64-bit expanded header - - Magic386 = (4*11+0)*11 + 7 - MagicAMD64 = (4*26+0)*26 + 7 + Magic64 - MagicARM = (4*20+0)*20 + 7 -)</pre> <h2 id="pkg-variables">Variables</h2> <p>ErrNoSymbols is returned by <a href="#File.Symbols">File.Symbols</a> if there is no such section in the File. </p> -<pre data-language="go">var ErrNoSymbols = errors.New("no symbol section")</pre> <h2 id="File">type <span>File</span> <span title="Added in Go 1.3">1.3</span> </h2> <p>A File represents an open Plan 9 a.out file. </p> -<pre data-language="go">type File struct { - FileHeader - Sections []*Section - // contains filtered or unexported fields -} -</pre> <h3 id="NewFile">func <span>NewFile</span> <span title="Added in Go 1.3">1.3</span> </h3> <pre data-language="go">func NewFile(r io.ReaderAt) (*File, error)</pre> <p>NewFile creates a new <a href="#File">File</a> for accessing a Plan 9 binary in an underlying reader. The Plan 9 binary is expected to start at position 0 in the ReaderAt. </p> -<h3 id="Open">func <span>Open</span> <span title="Added in Go 1.3">1.3</span> </h3> <pre data-language="go">func Open(name string) (*File, error)</pre> <p>Open opens the named file using <span>os.Open</span> and prepares it for use as a Plan 9 a.out binary. </p> -<h3 id="File.Close">func (*File) <span>Close</span> <span title="Added in Go 1.3">1.3</span> </h3> <pre data-language="go">func (f *File) Close() error</pre> <p>Close closes the <a href="#File">File</a>. If the <a href="#File">File</a> was created using <a href="#NewFile">NewFile</a> directly instead of <a href="#Open">Open</a>, Close has no effect. </p> -<h3 id="File.Section">func (*File) <span>Section</span> <span title="Added in Go 1.3">1.3</span> </h3> <pre data-language="go">func (f *File) Section(name string) *Section</pre> <p>Section returns a section with the given name, or nil if no such section exists. </p> -<h3 id="File.Symbols">func (*File) <span>Symbols</span> <span title="Added in Go 1.3">1.3</span> </h3> <pre data-language="go">func (f *File) Symbols() ([]Sym, error)</pre> <p>Symbols returns the symbol table for f. </p> -<h2 id="FileHeader">type <span>FileHeader</span> <span title="Added in Go 1.3">1.3</span> </h2> <p>A FileHeader represents a Plan 9 a.out file header. </p> -<pre data-language="go">type FileHeader struct { - Magic uint32 - Bss uint32 - Entry uint64 - PtrSize int - LoadAddress uint64 // Go 1.4 - HdrSize uint64 // Go 1.4 -} -</pre> <h2 id="Section">type <span>Section</span> <span title="Added in Go 1.3">1.3</span> </h2> <p>A Section represents a single section in a Plan 9 a.out file. </p> -<pre data-language="go">type Section struct { - SectionHeader - - // Embed ReaderAt for ReadAt method. - // Do not embed SectionReader directly - // to avoid having Read and Seek. - // If a client wants Read and Seek it must use - // Open() to avoid fighting over the seek offset - // with other clients. - io.ReaderAt - // contains filtered or unexported fields -} -</pre> <h3 id="Section.Data">func (*Section) <span>Data</span> <span title="Added in Go 1.3">1.3</span> </h3> <pre data-language="go">func (s *Section) Data() ([]byte, error)</pre> <p>Data reads and returns the contents of the Plan 9 a.out section. </p> -<h3 id="Section.Open">func (*Section) <span>Open</span> <span title="Added in Go 1.3">1.3</span> </h3> <pre data-language="go">func (s *Section) Open() io.ReadSeeker</pre> <p>Open returns a new ReadSeeker reading the Plan 9 a.out section. </p> -<h2 id="SectionHeader">type <span>SectionHeader</span> <span title="Added in Go 1.3">1.3</span> </h2> <p>A SectionHeader represents a single Plan 9 a.out section header. This structure doesn't exist on-disk, but eases navigation through the object file. </p> -<pre data-language="go">type SectionHeader struct { - Name string - Size uint32 - Offset uint32 -} -</pre> <h2 id="Sym">type <span>Sym</span> <span title="Added in Go 1.3">1.3</span> </h2> <p>A Symbol represents an entry in a Plan 9 a.out symbol table section. </p> -<pre data-language="go">type Sym struct { - Value uint64 - Type rune - Name string -} -</pre><div class="_attribution"> - <p class="_attribution-p"> - © Google, Inc.<br>Licensed under the Creative Commons Attribution License 3.0.<br> - <a href="http://golang.org/pkg/debug/plan9obj/" class="_attribution-link">http://golang.org/pkg/debug/plan9obj/</a> - </p> -</div> |
