/*
 * Copyright (c) 2001, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 *
 */

package sun.jvm.hotspot.debugger.posix.elf;

public interface ELFSectionHeader {
    
Undefined section header index. /** Undefined section header index. */
    public static final int NDX_UNDEFINED = 0;
    
Lower bound section header index. /** Lower bound section header index. */
    public static final int NDX_LORESERVE = 0xff00;
    
Lower bound section header index reserved for processor specific
semantics. /** Lower bound section header index reserved for processor specific
     * semantics. */
    public static final int NDX_LOPROC = 0xff00;
    
Upper bound section header index reserved for processor specific
semantics. /** Upper bound section header index reserved for processor specific
     * semantics. */
    public static final int NDX_HIPROC = 0xff1f;
    
Absolute values for the corresponding reference.  Symbols defined
relative to section number NDX_ABS have absolute values and are not
affected by relocation. /** Absolute values for the corresponding reference.  Symbols defined
     * relative to section number NDX_ABS have absolute values and are not
     * affected by relocation. */
    public static final int NDX_ABS = 0xfff1;
    
Symbols defined relative to this section are common symbols, such
as FORTRAN, COMMON or unallocated C external variables. /** Symbols defined relative to this section are common symbols, such
     * as FORTRAN, COMMON or unallocated C external variables. */
    public static final int NDX_COMMON = 0xfff2;
    
Upper bound section header index. /** Upper bound section header index. */
    public static final int NDX_HIRESERVE = 0xffff;

    
Section is inactive. /** Section is inactive. */
    public static final int TYPE_NULL = 0;
    
Section holds information defined by the program. /** Section holds information defined by the program. */
    public static final int TYPE_PROGBITS = 1;
    
Section holds symbol table information for link editing.  It may also
be used to store symbols for dynamic linking. /** Section holds symbol table information for link editing.  It may also
     * be used to store symbols for dynamic linking. */
    public static final int TYPE_SYMTBL = 2;
    
Section holds string table information. /** Section holds string table information. */
    public static final int TYPE_STRTBL = 3;
    
Section holds relocation entries with explicit addends. /** Section holds relocation entries with explicit addends. */
    public static final int TYPE_RELO_EXPLICIT = 4;
    
Section holds symbol hash table. /** Section holds symbol hash table. */
    public static final int TYPE_HASH = 5;
    
Section holds information for dynamic linking. /** Section holds information for dynamic linking. */
    public static final int TYPE_DYNAMIC = 6;
    
Section holds information that marks the file. /** Section holds information that marks the file. */
    public static final int TYPE_NOTE = 7;
    
Section occupies no space but resembles TYPE_PROGBITS. /** Section occupies no space but resembles TYPE_PROGBITS. */
    public static final int TYPE_NOBITS = 8;
    
Section holds relocation entries without explicit addends. /** Section holds relocation entries without explicit addends. */
    public static final int TYPE_RELO = 9;
    
Section is reserved but has unspecified semantics. /** Section is reserved but has unspecified semantics. */
    public static final int TYPE_SHLIB = 10;
    
Section holds a minimum set of dynamic linking symbols. /** Section holds a minimum set of dynamic linking symbols. */
    public static final int TYPE_DYNSYM = 11;
    
Lower bound section type that contains processor specific semantics. /** Lower bound section type that contains processor specific semantics. */
    public static final int TYPE_LOPROC = 0x70000000;
    
Upper bound section type that contains processor specific semantics. /** Upper bound section type that contains processor specific semantics. */
    public static final int TYPE_HIPROC = 0x7fffffff;
    
Lower bound of the range of indexes reserved for application
programs. /** Lower bound of the range of indexes reserved for application
     * programs. */
    public static final int TYPE_LOUSER = 0x80000000;
    
Upper bound of the range of indexes reserved for application
programs. /** Upper bound of the range of indexes reserved for application
     * programs. */
    public static final int TYPE_HIUSER = 0xffffffff;

    
Flag informing that this section contains data that should be writable
during process execution. /** Flag informing that this section contains data that should be writable
     * during process execution. */
    public static final int FLAG_WRITE = 0x1;
    
Flag informing that section occupies memory during process
execution. /** Flag informing that section occupies memory during process
     * execution. */
    public static final int FLAG_ALLOC = 0x2;
    
Flag informaing that section contains executable machine
instructions. /** Flag informaing that section contains executable machine
     * instructions. */
    public static final int FLAG_EXEC_INSTR = 0x4;
    
Flag informing that all the bits in the mask are reserved for processor
specific semantics. /** Flag informing that all the bits in the mask are reserved for processor
     * specific semantics. */
    public static final int FLAG_MASK = 0xf0000000;

    
Section header name identifying the section as a string table. /** Section header name identifying the section as a string table. */
    public static final String STRING_TABLE_NAME = ".strtab";
    
Section header name identifying the section as a dynamic string
table. /** Section header name identifying the section as a dynamic string
     * table. */
    public static final String DYNAMIC_STRING_TABLE_NAME = ".dynstr";
    
Returns the type of section header. /** Returns the type of section header. */
    public int getType();
    
Returns the number of symbols in this section or 0 if none. /** Returns the number of symbols in this section or 0 if none. */
    public int getNumberOfSymbols();
    
Returns the symbol at the specified index.  The ELF symbol at index 0
is the undefined symbol. /** Returns the symbol at the specified index.  The ELF symbol at index 0
     * is the undefined symbol. */
    public ELFSymbol getELFSymbol(int index);
    
Returns the string table for this section or null if one does not
exist. /** Returns the string table for this section or null if one does not
     * exist. */
    public ELFStringTable getStringTable();
    
Returns the hash table for this section or null if one does not
exist.  NOTE: currently the ELFHashTable does not work and this method
will always return null. /** Returns the hash table for this section or null if one does not
     * exist.  NOTE: currently the ELFHashTable does not work and this method
     * will always return null. */
    public ELFHashTable getHashTable();
    public int getLink();
    
Returns the name of the section or null if the section has no name. /** Returns the name of the section or null if the section has no name. */
    public String getName();
    
Returns the offset in bytes to the beginning of the section. /** Returns the offset in bytes to the beginning of the section. */
    public int getOffset();
}