kc3-lang/pkgconf/libpkgconf/libpkgconf.h

Tag - branch -master- tag -pkgconf-2.5.1pkgconf-2.5.0pkgconf-2.4.3pkgconf-2.4.2pkgconf-2.4.1pkgconf-2.4.0pkgconf-2.3.0pkgconf-2.2.0pkgconf-2.1.1pkgconf-2.1.0pkgconf-2.0.3pkgconf-2.0.2pkgconf-2.0.1pkgconf-2.0.0pkgconf-1.9.5pkgconf-1.9.4pkgconf-1.9.3pkgconf-1.9.2pkgconf-1.9.1pkgconf-1.9.0pkgconf-1.8.0pkgconf-1.7.4pkgconf-1.7.3pkgconf-1.7.2pkgconf-1.7.1pkgconf-1.7.0pkgconf-1.6.3pkgconf-1.6.2pkgconf-1.6.1pkgconf-1.6.0pkgconf-1.5.4pkgconf-1.5.3pkgconf-1.5.2pkgconf-1.5.1pkgconf-1.4.2pkgconf-1.4.1pkgconf-1.4.0pkgconf-1.3.90pkgconf-1.3.7pkgconf-1.3.6pkgconf-1.3.5pkgconf-1.3.4pkgconf-1.3.3pkgconf-1.3.2pkgconf-1.3.1pkgconf-1.3.0pkgconf-1.2.0pkgconf-1.1.0pkgconf-1.0.1pkgconf-1pkgconf-0.9.9pkgconf-0.9.8pkgconf-0.9.7pkgconf-0.9.6pkgconf-0.9.5pkgconf-0.9.4pkgconf-0.9.3pkgconf-0.9.2pkgconf-0.9.12pkgconf-0.9.11pkgconf-0.9.10pkgconf-0.9.1pkgconf-0.9.0pkgconf-0.8.9pkgconf-0.8.8pkgconf-0.8.7pkgconf-0.8.4pkgconf-0.8.3pkgconf-0.8.2pkgconf-0.8.12pkgconf-0.8.11pkgconf-0.8.10pkgconf-0.8.1pkgconf-0.8pkgconf-0.7pkgconf-0.6pkgconf-0.5.3pkgconf-0.5.2pkgconf-0.5.1pkgconf-0.5pkgconf-0.4pkgconf-0.3pkgconf-0.2pkgconf-0.1.1pkgconf-0.1

• Show log

  Commit

• Hash : 45d422c4
  Author :
  Date : 2016-07-10T15:20:31
  

  libpkgconf: implement PKG_CONFIG_LOG style auditing (closes #88)
  

Download

• libpkgconf/libpkgconf.h

• /*
   * libpkgconf.h
   * Global include file for everything in libpkgconf.
   *
   * Copyright (c) 2011, 2015 pkgconf authors (see AUTHORS).
   *
   * Permission to use, copy, modify, and/or distribute this software for any
   * purpose with or without fee is hereby granted, provided that the above
   * copyright notice and this permission notice appear in all copies.
   *
   * This software is provided 'as is' and without any warranty, express or
   * implied.  In no event shall the authors be liable for any damages arising
   * from the use of this software.
   */
  
  #ifndef LIBPKGCONF__LIBPKGCONF_H
  #define LIBPKGCONF__LIBPKGCONF_H
  
  #include <libpkgconf/config.h>
  #include <libpkgconf/stdinc.h>
  #include <libpkgconf/iter.h>
  #include <libpkgconf/bsdstubs.h>
  
  #define PKGCONF_BUFSIZE	(65535)
  
  typedef enum {
  	PKGCONF_CMP_ANY = 0,
  	PKGCONF_CMP_LESS_THAN,
  	PKGCONF_CMP_GREATER_THAN,
  	PKGCONF_CMP_LESS_THAN_EQUAL,
  	PKGCONF_CMP_GREATER_THAN_EQUAL,
  	PKGCONF_CMP_EQUAL,
  	PKGCONF_CMP_NOT_EQUAL,
  	PKGCONF_CMP_ALWAYS_MATCH,
  	PKGCONF_CMP_SIZE
  } pkgconf_pkg_comparator_t;
  
  typedef struct pkgconf_pkg_ pkgconf_pkg_t;
  typedef struct pkgconf_dependency_ pkgconf_dependency_t;
  typedef struct pkgconf_tuple_ pkgconf_tuple_t;
  typedef struct pkgconf_fragment_ pkgconf_fragment_t;
  
  #define PKGCONF_ARRAY_SIZE(x) (sizeof(x) / sizeof(*(x)))
  
  #define PKGCONF_FOREACH_LIST_ENTRY(head, value) \
  	for ((value) = (head); (value) != NULL; (value) = (value)->next)
  
  #define PKGCONF_FOREACH_LIST_ENTRY_SAFE(head, nextiter, value) \
  	for ((value) = (head), (nextiter) = (head) != NULL ? (head)->next : NULL; (value) != NULL; (value) = (nextiter), (nextiter) = (nextiter) != NULL ? (nextiter)->next : NULL)
  
  #define PKGCONF_FOREACH_LIST_ENTRY_REVERSE(tail, value) \
  	for ((value) = (tail); (value) != NULL; (value) = (value)->prev)
  
  struct pkgconf_fragment_ {
  	pkgconf_node_t iter;
  
  	char type;
  	char *data;
  };
  
  struct pkgconf_dependency_ {
  	pkgconf_node_t iter;
  
  	char *package;
  	pkgconf_pkg_comparator_t compare;
  	char *version;
  	pkgconf_pkg_t *parent;
  };
  
  struct pkgconf_tuple_ {
  	pkgconf_node_t iter;
  
  	char *key;
  	char *value;
  };
  
  #define PKGCONF_PKG_PROPF_NONE			0x0
  #define PKGCONF_PKG_PROPF_VIRTUAL		0x1
  #define PKGCONF_PKG_PROPF_CACHED		0x2
  #define PKGCONF_PKG_PROPF_SEEN			0x4
  #define PKGCONF_PKG_PROPF_UNINSTALLED		0x8
  
  struct pkgconf_pkg_ {
  	pkgconf_node_t cache_iter;
  
  	int refcount;
  	char *id;
  	char *filename;
  	char *realname;
  	char *version;
  	char *description;
  	char *url;
  	char *pc_filedir;
  
  	pkgconf_list_t libs;
  	pkgconf_list_t libs_private;
  	pkgconf_list_t cflags;
  	pkgconf_list_t cflags_private;
  
  	pkgconf_list_t requires;
  	pkgconf_list_t requires_private;
  	pkgconf_list_t conflicts;
  
  	pkgconf_list_t vars;
  
  	unsigned int flags;
  };
  
  #define PKGCONF_IS_MODULE_SEPARATOR(c) ((c) == ',' || isspace ((unsigned int)(c)))
  #define PKGCONF_IS_OPERATOR_CHAR(c) ((c) == '<' || (c) == '>' || (c) == '!' || (c) == '=')
  
  #define PKGCONF_PKG_PKGF_NONE				0x000
  #define PKGCONF_PKG_PKGF_SEARCH_PRIVATE			0x001
  #define PKGCONF_PKG_PKGF_ENV_ONLY			0x002
  #define PKGCONF_PKG_PKGF_NO_UNINSTALLED			0x004
  #define PKGCONF_PKG_PKGF_SKIP_ROOT_VIRTUAL		0x008
  #define PKGCONF_PKG_PKGF_MERGE_PRIVATE_FRAGMENTS	0x010
  #define PKGCONF_PKG_PKGF_SKIP_CONFLICTS			0x020
  #define PKGCONF_PKG_PKGF_NO_CACHE			0x040
  #define PKGCONF_PKG_PKGF_MUNGE_SYSROOT_PREFIX		0x080
  #define PKGCONF_PKG_PKGF_SKIP_ERRORS			0x100
  #define PKGCONF_PKG_PKGF_ITER_PKG_IS_PRIVATE		0x200
  
  #define PKGCONF_PKG_ERRF_OK			0x0
  #define PKGCONF_PKG_ERRF_PACKAGE_NOT_FOUND	0x1
  #define PKGCONF_PKG_ERRF_PACKAGE_VER_MISMATCH	0x2
  #define PKGCONF_PKG_ERRF_PACKAGE_CONFLICT	0x4
  #define PKGCONF_PKG_ERRF_DEPGRAPH_BREAK		0x8
  
  typedef void (*pkgconf_pkg_iteration_func_t)(const pkgconf_pkg_t *pkg);
  typedef void (*pkgconf_pkg_traverse_func_t)(pkgconf_pkg_t *pkg, void *data, unsigned int flags);
  typedef bool (*pkgconf_queue_apply_func_t)(pkgconf_pkg_t *world, void *data, int maxdepth, unsigned int flags);
  typedef bool (*pkgconf_error_handler_func_t)(const char *msg);
  
  /* pkg.c */
  #if defined(__GNUC__) || defined(__INTEL_COMPILER)
  #define PRINTFLIKE(fmtarg, firstvararg) \
          __attribute__((__format__ (__printf__, fmtarg, firstvararg)))
  #define DEPRECATED \
          __attribute__((deprecated))
  #else
  #define PRINTFLIKE(fmtarg, firstvararg)
  #define DEPRECATED
  #endif /* defined(__INTEL_COMPILER) || defined(__GNUC__) */
  
  bool pkgconf_error(const char *format, ...) PRINTFLIKE(1, 2);
  bool pkgconf_default_error_handler(const char *msg);
  void pkgconf_set_error_handler(pkgconf_error_handler_func_t func);
  
  pkgconf_pkg_t *pkgconf_pkg_ref(pkgconf_pkg_t *pkg);
  void pkgconf_pkg_unref(pkgconf_pkg_t *pkg);
  void pkgconf_pkg_free(pkgconf_pkg_t *pkg);
  pkgconf_pkg_t *pkgconf_pkg_find(const char *name, unsigned int flags);
  unsigned int pkgconf_pkg_traverse(pkgconf_pkg_t *root, pkgconf_pkg_traverse_func_t func, void *data, int maxdepth, unsigned int flags);
  unsigned int pkgconf_pkg_verify_graph(pkgconf_pkg_t *root, int depth, unsigned int flags);
  pkgconf_pkg_t *pkgconf_pkg_verify_dependency(pkgconf_dependency_t *pkgdep, unsigned int flags, unsigned int *eflags);
  const char *pkgconf_pkg_get_comparator(const pkgconf_dependency_t *pkgdep);
  int pkgconf_pkg_cflags(pkgconf_pkg_t *root, pkgconf_list_t *list, int maxdepth, unsigned int flags);
  int pkgconf_pkg_libs(pkgconf_pkg_t *root, pkgconf_list_t *list, int maxdepth, unsigned int flags);
  pkgconf_pkg_comparator_t pkgconf_pkg_comparator_lookup_by_name(const char *name);
  
  int pkgconf_compare_version(const char *a, const char *b);
  void pkgconf_scan_all(pkgconf_pkg_iteration_func_t func);
  
  /* parse.c */
  pkgconf_pkg_t *pkgconf_pkg_new_from_file(const char *path, FILE *f, unsigned int flags);
  void pkgconf_dependency_parse_str(pkgconf_list_t *deplist_head, const char *depends);
  void pkgconf_dependency_parse(pkgconf_pkg_t *pkg, pkgconf_list_t *deplist_head, const char *depends);
  void pkgconf_dependency_append(pkgconf_list_t *list, pkgconf_dependency_t *tail);
  void pkgconf_dependency_free(pkgconf_list_t *list);
  
  /* argvsplit.c */
  int pkgconf_argv_split(const char *src, int *argc, char ***argv);
  void pkgconf_argv_free(char **argv);
  
  /* fragment.c */
  void pkgconf_fragment_parse(pkgconf_list_t *list, pkgconf_list_t *vars, const char *value, unsigned int flags);
  void pkgconf_fragment_add(pkgconf_list_t *list, const char *string, unsigned int flags);
  void pkgconf_fragment_copy(pkgconf_list_t *list, pkgconf_fragment_t *base, unsigned int flags, bool is_private);
  void pkgconf_fragment_delete(pkgconf_list_t *list, pkgconf_fragment_t *node);
  void pkgconf_fragment_free(pkgconf_list_t *list);
  
  /* fileio.c */
  char *pkgconf_fgetline(char *line, size_t size, FILE *stream);
  
  /* tuple.c */
  pkgconf_tuple_t *pkgconf_tuple_add(pkgconf_list_t *parent, const char *key, const char *value, bool parse);
  char *pkgconf_tuple_find(pkgconf_list_t *list, const char *key);
  char *pkgconf_tuple_parse(pkgconf_list_t *list, const char *value);
  void pkgconf_tuple_free(pkgconf_list_t *list);
  void pkgconf_tuple_add_global(const char *key, const char *value);
  char *pkgconf_tuple_find_global(const char *key);
  void pkgconf_tuple_free_global(void);
  void pkgconf_tuple_define_global(const char *kv);
  
  /* queue.c */
  void pkgconf_queue_push(pkgconf_list_t *list, const char *package);
  bool pkgconf_queue_compile(pkgconf_pkg_t *world, pkgconf_list_t *list);
  void pkgconf_queue_free(pkgconf_list_t *list);
  bool pkgconf_queue_apply(pkgconf_list_t *list, pkgconf_queue_apply_func_t func, int maxdepth, unsigned int flags, void *data);
  bool pkgconf_queue_validate(pkgconf_list_t *list, int maxdepth, unsigned int flags);
  
  /* cache.c */
  pkgconf_pkg_t *pkgconf_cache_lookup(const char *id);
  void pkgconf_cache_add(pkgconf_pkg_t *pkg);
  void pkgconf_cache_remove(pkgconf_pkg_t *pkg);
  void pkgconf_cache_free(void);
  
  /* audit.c */
  void pkgconf_audit_open_log(FILE *auditf);
  void pkgconf_audit_log(const char *format, ...) PRINTFLIKE(1, 2);
  void pkgconf_audit_log_dependency(const pkgconf_pkg_t *dep, const pkgconf_dependency_t *depnode);
  
  #endif
  

Download