xref: /llvm-project/lldb/bindings/interface/SBSectionDocstrings.i (revision 662548c82683bd8657a3179afee693c4965a3dfd)
1*662548c8SAlex Langford %feature("docstring",
2*662548c8SAlex Langford "Represents an executable image section.
3*662548c8SAlex Langford 
4*662548c8SAlex Langford SBSection supports iteration through its subsection, represented as SBSection
5*662548c8SAlex Langford as well.  For example, ::
6*662548c8SAlex Langford 
7*662548c8SAlex Langford     for sec in exe_module:
8*662548c8SAlex Langford         if sec.GetName() == '__TEXT':
9*662548c8SAlex Langford             print sec
10*662548c8SAlex Langford             break
11*662548c8SAlex Langford     print INDENT + 'Number of subsections: %d' % sec.GetNumSubSections()
12*662548c8SAlex Langford     for subsec in sec:
13*662548c8SAlex Langford         print INDENT + repr(subsec)
14*662548c8SAlex Langford 
15*662548c8SAlex Langford produces: ::
16*662548c8SAlex Langford 
17*662548c8SAlex Langford   [0x0000000100000000-0x0000000100002000) a.out.__TEXT
18*662548c8SAlex Langford       Number of subsections: 6
19*662548c8SAlex Langford       [0x0000000100001780-0x0000000100001d5c) a.out.__TEXT.__text
20*662548c8SAlex Langford       [0x0000000100001d5c-0x0000000100001da4) a.out.__TEXT.__stubs
21*662548c8SAlex Langford       [0x0000000100001da4-0x0000000100001e2c) a.out.__TEXT.__stub_helper
22*662548c8SAlex Langford       [0x0000000100001e2c-0x0000000100001f10) a.out.__TEXT.__cstring
23*662548c8SAlex Langford       [0x0000000100001f10-0x0000000100001f68) a.out.__TEXT.__unwind_info
24*662548c8SAlex Langford       [0x0000000100001f68-0x0000000100001ff8) a.out.__TEXT.__eh_frame
25*662548c8SAlex Langford 
26*662548c8SAlex Langford See also :py:class:`SBModule` ."
27*662548c8SAlex Langford ) lldb::SBSection;
28*662548c8SAlex Langford 
29*662548c8SAlex Langford %feature("docstring", "
30*662548c8SAlex Langford     Return the size of a target's byte represented by this section
31*662548c8SAlex Langford     in numbers of host bytes. Note that certain architectures have
32*662548c8SAlex Langford     varying minimum addressable unit (i.e. byte) size for their
33*662548c8SAlex Langford     CODE or DATA buses.
34*662548c8SAlex Langford 
35*662548c8SAlex Langford     @return
36*662548c8SAlex Langford         The number of host (8-bit) bytes needed to hold a target byte"
37*662548c8SAlex Langford ) lldb::SBSection::GetTargetByteSize;
38