thodg/libgit2/src/util/runtime.h
Branch
-
Show log
Commit
-
Hash : c3b7ace9
Author :
Date : 2021-11-14T16:43:53
refactor: make util an object library Instead of simply including the utility files directly, make them a cmake object library for easy reusability between other projects within libgit2. Now the top-level `src` is responsible for platform selection, while the next-level `libgit2` and `util` configurations are responsible for identifying what objects they include.
-
src/util/runtime.h
-
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62
/* * 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 "git2_util.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 outstanding 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