thodg/libgit2/src/runtime.h

• Show log

  Commit

• Hash : 6c51014d
  Author :
  Date : 2020-07-11T14:24:17
  

  libgit2: provide init_count of the library A function to provide the initialization count of the library; this is subject to race conditions but is useful for a naive determination as to whether the library has been initialized or not.

Download

• src/runtime.h

• /*
   * Copyright (C) the libgit2 contributors. All rights reserved.
   *
   * This file is part of libgit2, distributed under the GNU GPL v2 with
   * a Linking Exception. For full terms see the included COPYING file.
   */
  #ifndef INCLUDE_runtime_h__
  #define INCLUDE_runtime_h__
  
  #include "common.h"
  
  typedef int (*git_runtime_init_fn)(void);
  typedef void (*git_runtime_shutdown_fn)(void);
  
  /**
   * Start up a new runtime.  If this is the first time that this
   * function is called within the context of the current library
   * or executable, then the given `init_fns` will be invoked.  If
   * it is not the first time, they will be ignored.
   *
   * The given initialization functions _may_ register shutdown
   * handlers using `git_runtime_shutdown_register` to be notified
   * when the runtime is shutdown.
   *
   * @param init_fns The list of initialization functions to call
   * @param cnt The number of init_fns
   * @return The number of initializations performed (including this one) or an error
   */
  int git_runtime_init(git_runtime_init_fn init_fns[], size_t cnt);
  
  /*
   * Returns the number of initializations active (the number of calls to
   * `git_runtime_init` minus the number of calls sto `git_runtime_shutdown`).
   * If 0, the runtime is not currently initialized.
   *
   * @return The number of initializations performed or an error
   */
  int git_runtime_init_count(void);
  
  /**
   * Shut down the runtime.  If this is the last shutdown call,
   * such that there are no remaining `init` calls, then any
   * shutdown hooks that have been registered will be invoked.
   *
   * The number of oustanding initializations will be returned.
   * If this number is 0, then the runtime is shutdown.
   *
   * @return The number of outstanding initializations (after this one) or an error
   */
  int git_runtime_shutdown(void);
  
  /**
   * Register a shutdown handler for this runtime.  This should be done
   * by a function invoked by `git_runtime_init` to ensure that the
   * appropriate locks are taken.
   *
   * @param callback The shutdown handler callback
   * @return 0 or an error code
   */
  int git_runtime_shutdown_register(git_runtime_shutdown_fn callback);
  
  #endif
  

Download