injector.h

Go to the documentation of this file.

/* -*- indent-tabs-mode: nil -*-
 *
 * injector - Library for injecting a shared library into a Linux process
 *
 * URL: https://github.com/kubo/injector
 *
 * ------------------------------------------------------
 *
 * Copyright (C) 2018-2023 Kubo Takehiro <kubo@jiubao.org>
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */
 
#ifndef INJECTOR_H
#define INJECTOR_H
 
#if defined(_WIN32)
#include <windows.h>
typedef DWORD injector_pid_t;
#else
#include <sys/types.h>
 
typedef pid_t injector_pid_t;
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
#if 0
}
#endif
 
#define INJERR_SUCCESS 0               /* linux, windows, macos */
#define INJERR_OTHER -1                /* linux, windows, macos */
#define INJERR_NO_MEMORY -2            /* linux, windows, macos */
#define INJERR_NO_PROCESS -3           /* linux, windows, macos */
#define INJERR_NO_LIBRARY -4           /* linux */
#define INJERR_NO_FUNCTION -4          /* linux */
#define INJERR_ERROR_IN_TARGET -5      /* linux, windows, macos */
#define INJERR_FILE_NOT_FOUND -6       /* linux, windows, macos */
#define INJERR_INVALID_MEMORY_AREA -7  /* linux, macos */
#define INJERR_PERMISSION -8           /* linux, windows, macos */
#define INJERR_UNSUPPORTED_TARGET -9   /* linux, windows, macos */
#define INJERR_INVALID_ELF_FORMAT -10  /* linux */
#define INJERR_WAIT_TRACEE -11         /* linux */
#define INJERR_FUNCTION_MISSING -12    /* linux, windows, macos */
 
typedef struct injector injector_t;
 
int injector_attach(injector_t **injector, injector_pid_t pid);
 
int injector_detach(injector_t *injector);
 
int injector_inject(injector_t *injector, const char *path, void **handle);
 
int injector_uninject(injector_t *injector, void *handle);
 
#if defined(INJECTOR_DOC) || defined(__linux__) || defined(__APPLE__)
int injector_call(injector_t *injector, void *handle, const char* name);
#endif
 
const char *injector_error(void);
 
#if defined(INJECTOR_DOC) || defined(__linux__) || defined(_WIN32)
#define INJECTOR_HAS_REMOTE_CALL_FUNCS 1
#include <stdarg.h>
#include <stdint.h>
 
int injector_remote_func_addr(injector_t *injector, void *handle, const char* name, size_t *func_addr_out);
 
int injector_remote_call(injector_t *injector, intptr_t *retval, size_t func_addr, ...);
 
int injector_remote_vcall(injector_t *injector, intptr_t *retval, size_t func_addr, va_list ap);
#endif
 
#if defined(INJECTOR_DOC) || defined(_WIN32)
int injector_inject_w(injector_t *injector, const wchar_t *path, void **handle);
#endif
 
#if defined(INJECTOR_DOC) || (defined(__linux__) && defined(__x86_64__))
#define INJECTOR_HAS_INJECT_IN_CLONED_THREAD 1 // feature test macro
int injector_inject_in_cloned_thread(injector_t *injector, const char *path, void **handle);
#endif
 
#if 0
{
#endif
#ifdef __cplusplus
}; /* extern "C" */
#endif
 
#endif