1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License, Version 1.0 only
   6  * (the "License").  You may not use this file except in compliance
   7  * with the License.
   8  *
   9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  10  * or http://www.opensolaris.org/os/licensing.
  11  * See the License for the specific language governing permissions
  12  * and limitations under the License.
  13  *
  14  * When distributing Covered Code, include this CDDL HEADER in each
  15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  16  * If applicable, add the following below this CDDL HEADER, with the
  17  * fields enclosed by brackets "[]" replaced with your own identifying
  18  * information: Portions Copyright [yyyy] [name of copyright owner]
  19  *
  20  * CDDL HEADER END
  21  */
  22 /*
  23  * Copyright 2001-2003 Sun Microsystems, Inc.  All rights reserved.
  24  * Use is subject to license terms.
  25  */
  26 /*
  27  * Copyright (c) 2015, Joyent, Inc.
  28  */
  29 
  30 /*
  31  * This header file defines the interfaces available from the CTF debugger
  32  * library, libctf.  This library provides functions that a debugger can
  33  * use to operate on data in the Compact ANSI-C Type Format (CTF).  This
  34  * is NOT a public interface, although it may eventually become one in
  35  * the fullness of time after we gain more experience with the interfaces.
  36  *
  37  * In the meantime, be aware that any program linked with libctf in this
  38  * release of illumos is almost guaranteed to break in the next release.
  39  *
  40  * In short, do not user this header file or libctf for any purpose.
  41  */
  42 
  43 #ifndef _LIBCTF_H
  44 #define _LIBCTF_H
  45 
  46 #include <sys/ctf_api.h>
  47 
  48 #ifdef  __cplusplus
  49 extern "C" {
  50 #endif
  51 
  52 /*
  53  * This flag can be used to enable debug messages.
  54  */
  55 extern int _libctf_debug;
  56 
  57 typedef enum ctf_diff_flag {
  58         CTF_DIFF_F_IGNORE_INTNAMES = 0x01
  59 } ctf_diff_flag_t;
  60 
  61 typedef struct ctf_diff ctf_diff_t;
  62 typedef void (*ctf_diff_type_f)(ctf_file_t *, ctf_id_t, boolean_t, ctf_file_t *,
  63     ctf_id_t, void *);
  64 typedef void (*ctf_diff_func_f)(ctf_file_t *, ulong_t, boolean_t, ctf_file_t *,
  65     ulong_t, void *);
  66 typedef void (*ctf_diff_obj_f)(ctf_file_t *, ulong_t, ctf_id_t, boolean_t,
  67     ctf_file_t *, ulong_t, ctf_id_t, void *);
  68 
  69 extern int ctf_diff_init(ctf_file_t *, ctf_file_t *, ctf_diff_t **);
  70 extern uint_t ctf_diff_getflags(ctf_diff_t *);
  71 extern int ctf_diff_setflags(ctf_diff_t *, uint_t);
  72 extern int ctf_diff_types(ctf_diff_t *, ctf_diff_type_f, void *);
  73 extern int ctf_diff_functions(ctf_diff_t *, ctf_diff_func_f, void *);
  74 extern int ctf_diff_objects(ctf_diff_t *, ctf_diff_obj_f, void *);
  75 extern void ctf_diff_fini(ctf_diff_t *);
  76 
  77 #define CTF_CONVERT_F_IGNNONC   0x01
  78 extern ctf_file_t *ctf_fdconvert(int, const char *, uint_t, uint_t, int *,
  79     char *, size_t);
  80 
  81 typedef struct ctf_merge_handle ctf_merge_t;
  82 extern ctf_merge_t *ctf_merge_init(int, int *);
  83 extern int ctf_merge_add(ctf_merge_t *, ctf_file_t *);
  84 extern int ctf_merge_set_nthreads(ctf_merge_t *, const uint_t);
  85 extern int ctf_merge_label(ctf_merge_t *, const char *);
  86 extern int ctf_merge_uniquify(ctf_merge_t *, ctf_file_t *, const char *);
  87 extern int ctf_merge_merge(ctf_merge_t *, ctf_file_t **);
  88 extern int ctf_merge_dedup(ctf_merge_t *, ctf_file_t **);
  89 extern void ctf_merge_fini(ctf_merge_t *);
  90 
  91 #define CTF_ELFWRITE_F_COMPRESS         0x1
  92 extern int ctf_elffdwrite(ctf_file_t *, int, int, int);
  93 extern int ctf_elfwrite(ctf_file_t *, const char *, const char *, int);
  94 
  95 #ifdef  __cplusplus
  96 }
  97 #endif
  98 
  99 #endif  /* _LIBCTF_H */