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