Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ldr_entry(3)

ldr_xload(3)

load(3)

ldr_xentry(3)  —  Subroutines

OSF

NAME

ldr_xentry − Returns the entry point for a module loaded in another process

LIBRARY

Standard C Library (libc.a)

SYNOPSIS

#include <sys/types.h>
#include <loader.h>
int ldr_xentry(
ldr_process_tprocess,
ldr_module_t mod_id,
ldr_entry_pt_t ∗entry_pt);

PARAMETERS

processSpecifies the process whose address space contains the module for which the entry point is required. 

mod_idIdentifies the loaded module.  The module ID is returned when the module is first loaded. 

entry_ptPoints to a buffer in which the entry point will be returned. 

DESCRIPTION

The ldr_xentry() function returns the entry point for the specified module in the address space of the specified process. 

To obtain the unique identifier for the current process, use the following call: ldr_process_t ldr_my_process(); To obtain the unique identifier for the kernel, use the following call:  ldr_process_t ldr_kernel_process();

NOTES

This function currently works only for the current process and the kernel process. 

RETURN VALUES

Upon successful completion, the function returns a value of 0 (zero).  If the operation fails, the function returns a negative value and errno is set to indicate the error. 

ERRORS

If the ldr_xentry() function fails, errno may be set to one of the following values:

[EINVAL]The specified module ID is not valid. 

[EINVAL]There is no entry point for the loaded module. 

[ESRCH]The process identifier is invalid. 

Additional errors may occur due to the underlying IPC mechanism. 

RELATED INFORMATION

Functions: ldr_entry(3), ldr_xload(3), load(3)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026