NAME

ldr_xattach − Attaches to another process to permit loading/unloading of modules in that process’ address space

LIBRARY

Standard C Library (libc.a)

SYNOPSIS

#include <sys/types.h>
#include <loader.h> int ldr_xattach(
ldr_process_t process );

PARAMETERS

processSpecifies the process to attach to. 

DESCRIPTION

The ldr_xattach() function is used to permit a process to load, unload, query, or retrieve the contents of another process’ address space.  Before a call to the ldr_xload(), ldr_xunload(), or ldr_xlookup_package() functions, the ldr_xattach function must be performed to that process. 

NOTES

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

RETURN VALUES

If the attach operation is a success, the function returns a code of 0 (zero).  If the attach fails, the function returns a negative error value and errno is set to indicate the error. 

ERRORS

If the ldr_xattach() function fails, errno may be set to the following value:

[EINVAL]The process identified is nonshared and does not support loader operations. 

[ESRCH]The process identifier is invalid. 

Additional errors are possible from the underlying IPC mechanism. 

RELATED INFORMATION

Functions: ldr_xdetach(3), ldr_xunload(3), ldr_xlookup_package(3), ldr_xload(3)