/usr/include/gjs-1.0/gi/keep-alive.h is in libgjs-dev 1.32.0-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 | /* -*- mode: C; c-basic-offset: 4; indent-tabs-mode: nil; -*- */
/*
* Copyright (c) 2008 litl, LLC
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to
* deal in the Software without restriction, including without limitation the
* rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
* sell copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
* IN THE SOFTWARE.
*/
#ifndef __GJS_KEEP_ALIVE_H__
#define __GJS_KEEP_ALIVE_H__
#include <glib.h>
#include <jsapi.h>
G_BEGIN_DECLS
/* This is an alternative to JS_AddRoot().
*
* This "keep alive" object holds a collection of child objects and
* traces them when GC occurs. If the keep alive object is collected,
* it calls a notification function on all the child objects.
*
* The "global keep alive" is stuck on the global object as a property,
* so its children only get notified when the entire JSContext is
* blown away (or its global object replaced, I suppose, but that
* won't happen afaik).
*
* The problem with JS_AddRoot() is that it has no notification when the
* JSContext is destroyed. Also, it can be annoying to wrap a C type purely
* to put a finalizer on it, this lets you avoid that.
*
* All three fields (notify, child, and data) are optional, so you can have
* no JSObject - just notification+data - and you can have no notifier,
* only the keep-alive capability.
*/
typedef void (* GjsUnrootedFunc) (JSObject *obj,
void *data);
JSObject* gjs_keep_alive_new (JSContext *context);
void gjs_keep_alive_add_child (JSContext *context,
JSObject *keep_alive,
GjsUnrootedFunc notify,
JSObject *child,
void *data);
void gjs_keep_alive_remove_child (JSContext *context,
JSObject *keep_alive,
GjsUnrootedFunc notify,
JSObject *child,
void *data);
JSObject* gjs_keep_alive_get_global (JSContext *context);
void gjs_keep_alive_add_global_child (JSContext *context,
GjsUnrootedFunc notify,
JSObject *child,
void *data);
void gjs_keep_alive_remove_global_child (JSContext *context,
GjsUnrootedFunc notify,
JSObject *child,
void *data);
JSObject* gjs_keep_alive_get_for_import_global (JSContext *context);
G_END_DECLS
#endif /* __GJS_KEEP_ALIVE_H__ */
|