getsegbyname.3   [plain text]


.TH GETSEGBYNAME 3  "April 10, 1998" "Apple Computer, Inc."
.SH NAME
getsegbyname \- get the segment command for the named segment
.SH SYNOPSIS
.nf
\fB#include <mach-o/getsect.h>\fR
.PP
const struct segment_command *\fBgetsegbyname\fR(const char *\fIsegname\fR);
.fi
.SH DESCRIPTION
This routine returns the segment_command structure for the named segment if it
exists in the Mach-O (Mach object) executable
.IR getsegbyname (3)
is linked into.  Otherwise
.IR getsegbyname (3)
returns
.SM NULL.
It uses the link editor defined symbol _mh_execute_header and
just looks through the load commands.  Since these are mapped into the
.SM \_\|\_TEXT
segment they are read-only and thus
.I const
by default.
.SH "SEE ALSO"
end(3), getsectbyname(3)