summaryrefslogtreecommitdiff
path: root/ipc/kdbus/main.c
blob: c2117ea53bb56ccd8b960aed6d17100bed578d64 (plain)
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
/*
 * Copyright (C) 2013-2015 Kay Sievers
 * Copyright (C) 2013-2015 Greg Kroah-Hartman <gregkh@linuxfoundation.org>
 * Copyright (C) 2013-2015 Daniel Mack <daniel@zonque.org>
 * Copyright (C) 2013-2015 David Herrmann <dh.herrmann@gmail.com>
 * Copyright (C) 2013-2015 Linux Foundation
 *
 * kdbus is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License as published by the
 * Free Software Foundation; either version 2.1 of the License, or (at
 * your option) any later version.
 */

#define pr_fmt(fmt)    KBUILD_MODNAME ": " fmt
#include <linux/fs.h>
#include <linux/init.h>
#include <linux/module.h>

#include "util.h"
#include "fs.h"
#include "handle.h"
#include "metadata.h"
#include "node.h"

/*
 * This is a simplified outline of the internal kdbus object relations, for
 * those interested in the inner life of the driver implementation.
 *
 * From a mount point's (domain's) perspective:
 *
 * struct kdbus_domain
 *   |» struct kdbus_user *user (many, owned)
 *   '» struct kdbus_node node (embedded)
 *       |» struct kdbus_node children (many, referenced)
 *       |» struct kdbus_node *parent (pinned)
 *       '» struct kdbus_bus (many, pinned)
 *           |» struct kdbus_node node (embedded)
 *           '» struct kdbus_ep (many, pinned)
 *               |» struct kdbus_node node (embedded)
 *               |» struct kdbus_bus *bus (pinned)
 *               |» struct kdbus_conn conn_list (many, pinned)
 *               |   |» struct kdbus_ep *ep (pinned)
 *               |   |» struct kdbus_name_entry *activator_of (owned)
 *               |   |» struct kdbus_match_db *match_db (owned)
 *               |   |» struct kdbus_meta *meta (owned)
 *               |   |» struct kdbus_match_db *match_db (owned)
 *               |   |    '» struct kdbus_match_entry (many, owned)
 *               |   |
 *               |   |» struct kdbus_pool *pool (owned)
 *               |   |    '» struct kdbus_pool_slice *slices (many, owned)
 *               |   |       '» struct kdbus_pool *pool (pinned)
 *               |   |
 *               |   |» struct kdbus_user *user (pinned)
 *               |   `» struct kdbus_queue_entry entries (many, embedded)
 *               |        |» struct kdbus_pool_slice *slice (pinned)
 *               |        |» struct kdbus_conn_reply *reply (owned)
 *               |        '» struct kdbus_user *user (pinned)
 *               |
 *               '» struct kdbus_user *user (pinned)
 *                   '» struct kdbus_policy_db policy_db (embedded)
 *                        |» struct kdbus_policy_db_entry (many, owned)
 *                        |   |» struct kdbus_conn (pinned)
 *                        |   '» struct kdbus_ep (pinned)
 *                        |
 *                        '» struct kdbus_policy_db_cache_entry (many, owned)
 *                            '» struct kdbus_conn (pinned)
 *
 * For the life-time of a file descriptor derived from calling open() on a file
 * inside the mount point:
 *
 * struct kdbus_handle
 *  |» struct kdbus_meta *meta (owned)
 *  |» struct kdbus_ep *ep (pinned)
 *  |» struct kdbus_conn *conn (owned)
 *  '» struct kdbus_ep *ep (owned)
 */

static int __init kdbus_init(void)
{
	int ret;

	ret = sysfs_create_mount_point(fs_kobj, KBUILD_MODNAME);
	if (ret)
		return ret;

	ret = kdbus_fs_init();
	if (ret < 0) {
		pr_err("cannot register filesystem: %d\n", ret);
		goto exit_dir;
	}

	pr_info("initialized\n");
	return 0;

exit_dir:
	sysfs_remove_mount_point(fs_kobj, KBUILD_MODNAME);
	return ret;
}

static void __exit kdbus_exit(void)
{
	kdbus_fs_exit();
	sysfs_remove_mount_point(fs_kobj, KBUILD_MODNAME);
	ida_destroy(&kdbus_node_ida);
}

module_init(kdbus_init);
module_exit(kdbus_exit);
MODULE_LICENSE("GPL");
MODULE_DESCRIPTION("D-Bus, powerful, easy to use interprocess communication");
MODULE_ALIAS_FS(KBUILD_MODNAME "fs");