]>
Commit | Line | Data |
---|---|---|
db9ecf05 | 1 | /* SPDX-License-Identifier: LGPL-2.1-or-later */ |
57fa1d09 TG |
2 | #ifndef foosddevicehfoo |
3 | #define foosddevicehfoo | |
4 | ||
5 | /*** | |
57fa1d09 TG |
6 | systemd is free software; you can redistribute it and/or modify it |
7 | under the terms of the GNU Lesser General Public License as published by | |
8 | the Free Software Foundation; either version 2.1 of the License, or | |
9 | (at your option) any later version. | |
10 | ||
11 | systemd is distributed in the hope that it will be useful, but | |
12 | WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
14 | Lesser General Public License for more details. | |
15 | ||
16 | You should have received a copy of the GNU Lesser General Public License | |
85fce6f4 | 17 | along with systemd; If not, see <https://www.gnu.org/licenses/>. |
57fa1d09 TG |
18 | ***/ |
19 | ||
a1130022 | 20 | #include <errno.h> |
04c01369 | 21 | #include <inttypes.h> |
a1130022 | 22 | #include <sys/stat.h> |
27d13af7 | 23 | #include <sys/sysmacros.h> |
71d35b6b | 24 | #include <sys/types.h> |
57fa1d09 | 25 | |
b1c097af | 26 | #include "sd-event.h" |
b485fd93 | 27 | #include "sd-id128.h" |
b1c097af | 28 | |
57fa1d09 TG |
29 | #include "_sd-common.h" |
30 | ||
31 | _SD_BEGIN_DECLARATIONS; | |
32 | ||
33 | typedef struct sd_device sd_device; | |
96df036f | 34 | typedef struct sd_device_enumerator sd_device_enumerator; |
b1c097af YW |
35 | typedef struct sd_device_monitor sd_device_monitor; |
36 | ||
92100f14 | 37 | __extension__ typedef enum _SD_ENUM_TYPE_S64(sd_device_action_t) { |
a1130022 LP |
38 | SD_DEVICE_ADD, |
39 | SD_DEVICE_REMOVE, | |
40 | SD_DEVICE_CHANGE, | |
41 | SD_DEVICE_MOVE, | |
42 | SD_DEVICE_ONLINE, | |
43 | SD_DEVICE_OFFLINE, | |
44 | SD_DEVICE_BIND, | |
45 | SD_DEVICE_UNBIND, | |
46 | _SD_DEVICE_ACTION_MAX, | |
47 | _SD_DEVICE_ACTION_INVALID = -EINVAL, | |
5476cb98 | 48 | _SD_ENUM_FORCE_S64(DEVICE_ACTION) |
a1130022 LP |
49 | } sd_device_action_t; |
50 | ||
b1c097af YW |
51 | /* callback */ |
52 | ||
53 | typedef int (*sd_device_monitor_handler_t)(sd_device_monitor *m, sd_device *device, void *userdata); | |
96df036f TG |
54 | |
55 | /* device */ | |
57fa1d09 TG |
56 | |
57 | sd_device *sd_device_ref(sd_device *device); | |
58 | sd_device *sd_device_unref(sd_device *device); | |
59 | ||
60 | int sd_device_new_from_syspath(sd_device **ret, const char *syspath); | |
61 | int sd_device_new_from_devnum(sd_device **ret, char type, dev_t devnum); | |
62 | int sd_device_new_from_subsystem_sysname(sd_device **ret, const char *subsystem, const char *sysname); | |
63 | int sd_device_new_from_device_id(sd_device **ret, const char *id); | |
a1130022 | 64 | int sd_device_new_from_stat_rdev(sd_device **ret, const struct stat *st); |
e418f965 YW |
65 | int sd_device_new_from_devname(sd_device **ret, const char *devname); |
66 | int sd_device_new_from_path(sd_device **ret, const char *path); | |
bd44a727 YW |
67 | int sd_device_new_from_ifname(sd_device **ret, const char *ifname); |
68 | int sd_device_new_from_ifindex(sd_device **ret, int ifindex); | |
57fa1d09 | 69 | |
68a52f59 YW |
70 | int sd_device_new_child(sd_device **ret, sd_device *device, const char *suffix); |
71 | ||
57fa1d09 TG |
72 | int sd_device_get_parent(sd_device *child, sd_device **ret); |
73 | int sd_device_get_parent_with_subsystem_devtype(sd_device *child, const char *subsystem, const char *devtype, sd_device **ret); | |
74 | ||
75 | int sd_device_get_syspath(sd_device *device, const char **ret); | |
76 | int sd_device_get_subsystem(sd_device *device, const char **ret); | |
44bc6f3c | 77 | int sd_device_get_driver_subsystem(sd_device *device, const char **ret); |
57fa1d09 TG |
78 | int sd_device_get_devtype(sd_device *device, const char **ret); |
79 | int sd_device_get_devnum(sd_device *device, dev_t *devnum); | |
80 | int sd_device_get_ifindex(sd_device *device, int *ifindex); | |
81 | int sd_device_get_driver(sd_device *device, const char **ret); | |
82 | int sd_device_get_devpath(sd_device *device, const char **ret); | |
83 | int sd_device_get_devname(sd_device *device, const char **ret); | |
84 | int sd_device_get_sysname(sd_device *device, const char **ret); | |
85 | int sd_device_get_sysnum(sd_device *device, const char **ret); | |
a1130022 LP |
86 | int sd_device_get_action(sd_device *device, sd_device_action_t *ret); |
87 | int sd_device_get_seqnum(sd_device *device, uint64_t *ret); | |
122adcb2 | 88 | int sd_device_get_diskseq(sd_device *device, uint64_t *ret); |
1ff0164b | 89 | int sd_device_get_device_id(sd_device *device, const char **ret); |
57fa1d09 | 90 | |
5a937ea2 | 91 | int sd_device_get_is_initialized(sd_device *device); |
4eb5f1db YW |
92 | int sd_device_get_usec_initialized(sd_device *device, uint64_t *ret); |
93 | int sd_device_get_usec_since_initialized(sd_device *device, uint64_t *ret); | |
57fa1d09 | 94 | |
bfd5a068 ZJS |
95 | const char* sd_device_get_tag_first(sd_device *device); |
96 | const char* sd_device_get_tag_next(sd_device *device); | |
97 | const char* sd_device_get_current_tag_first(sd_device *device); | |
98 | const char* sd_device_get_current_tag_next(sd_device *device); | |
99 | const char* sd_device_get_devlink_first(sd_device *device); | |
100 | const char* sd_device_get_devlink_next(sd_device *device); | |
101 | const char* sd_device_get_property_first(sd_device *device, const char **value); | |
102 | const char* sd_device_get_property_next(sd_device *device, const char **value); | |
103 | const char* sd_device_get_sysattr_first(sd_device *device); | |
104 | const char* sd_device_get_sysattr_next(sd_device *device); | |
ec9b4f2b YW |
105 | sd_device *sd_device_get_child_first(sd_device *device, const char **ret_suffix); |
106 | sd_device *sd_device_get_child_next(sd_device *device, const char **ret_suffix); | |
57fa1d09 TG |
107 | |
108 | int sd_device_has_tag(sd_device *device, const char *tag); | |
e77b146f | 109 | int sd_device_has_current_tag(sd_device *device, const char *tag); |
57fa1d09 | 110 | int sd_device_get_property_value(sd_device *device, const char *key, const char **value); |
b485fd93 | 111 | int sd_device_get_trigger_uuid(sd_device *device, sd_id128_t *ret); |
57fa1d09 TG |
112 | int sd_device_get_sysattr_value(sd_device *device, const char *sysattr, const char **_value); |
113 | ||
8aae9a66 | 114 | int sd_device_set_sysattr_value(sd_device *device, const char *sysattr, const char *value); |
ea2bc257 | 115 | int sd_device_set_sysattr_valuef(sd_device *device, const char *sysattr, const char *format, ...) _sd_printf_(3, 4); |
f4d36efa | 116 | int sd_device_trigger(sd_device *device, sd_device_action_t action); |
b485fd93 | 117 | int sd_device_trigger_with_uuid(sd_device *device, sd_device_action_t action, sd_id128_t *ret_uuid); |
f9a726ab | 118 | int sd_device_open(sd_device *device, int flags); |
57fa1d09 | 119 | |
96df036f TG |
120 | /* device enumerator */ |
121 | ||
122 | int sd_device_enumerator_new(sd_device_enumerator **ret); | |
123 | sd_device_enumerator *sd_device_enumerator_ref(sd_device_enumerator *enumerator); | |
124 | sd_device_enumerator *sd_device_enumerator_unref(sd_device_enumerator *enumerator); | |
125 | ||
96df036f TG |
126 | sd_device *sd_device_enumerator_get_device_first(sd_device_enumerator *enumerator); |
127 | sd_device *sd_device_enumerator_get_device_next(sd_device_enumerator *enumerator); | |
128 | sd_device *sd_device_enumerator_get_subsystem_first(sd_device_enumerator *enumerator); | |
129 | sd_device *sd_device_enumerator_get_subsystem_next(sd_device_enumerator *enumerator); | |
130 | ||
131 | int sd_device_enumerator_add_match_subsystem(sd_device_enumerator *enumerator, const char *subsystem, int match); | |
132 | int sd_device_enumerator_add_match_sysattr(sd_device_enumerator *enumerator, const char *sysattr, const char *value, int match); | |
133 | int sd_device_enumerator_add_match_property(sd_device_enumerator *enumerator, const char *property, const char *value); | |
fe2a6dce | 134 | int sd_device_enumerator_add_match_property_required(sd_device_enumerator *enumerator, const char *property, const char *value); |
96df036f | 135 | int sd_device_enumerator_add_match_sysname(sd_device_enumerator *enumerator, const char *sysname); |
94097100 | 136 | int sd_device_enumerator_add_nomatch_sysname(sd_device_enumerator *enumerator, const char *sysname); |
96df036f TG |
137 | int sd_device_enumerator_add_match_tag(sd_device_enumerator *enumerator, const char *tag); |
138 | int sd_device_enumerator_add_match_parent(sd_device_enumerator *enumerator, sd_device *parent); | |
dee5e0b6 | 139 | int sd_device_enumerator_allow_uninitialized(sd_device_enumerator *enumerator); |
96df036f | 140 | |
b1c097af YW |
141 | /* device monitor */ |
142 | ||
143 | int sd_device_monitor_new(sd_device_monitor **ret); | |
144 | sd_device_monitor *sd_device_monitor_ref(sd_device_monitor *m); | |
145 | sd_device_monitor *sd_device_monitor_unref(sd_device_monitor *m); | |
146 | ||
bab889c5 | 147 | int sd_device_monitor_get_fd(sd_device_monitor *m); |
5ab12505 YW |
148 | int sd_device_monitor_get_events(sd_device_monitor *m); |
149 | int sd_device_monitor_get_timeout(sd_device_monitor *m, uint64_t *ret); | |
b1c097af | 150 | int sd_device_monitor_set_receive_buffer_size(sd_device_monitor *m, size_t size); |
deb2b734 | 151 | int sd_device_monitor_attach_event(sd_device_monitor *m, sd_event *event); |
b1c097af YW |
152 | int sd_device_monitor_detach_event(sd_device_monitor *m); |
153 | sd_event *sd_device_monitor_get_event(sd_device_monitor *m); | |
bf7712b6 | 154 | sd_event_source *sd_device_monitor_get_event_source(sd_device_monitor *m); |
39f11aa4 YW |
155 | int sd_device_monitor_set_description(sd_device_monitor *m, const char *description); |
156 | int sd_device_monitor_get_description(sd_device_monitor *m, const char **ret); | |
ece1e280 | 157 | int sd_device_monitor_is_running(sd_device_monitor *m); |
deb2b734 | 158 | int sd_device_monitor_start(sd_device_monitor *m, sd_device_monitor_handler_t callback, void *userdata); |
b1c097af | 159 | int sd_device_monitor_stop(sd_device_monitor *m); |
bab889c5 | 160 | int sd_device_monitor_receive(sd_device_monitor *m, sd_device **ret); |
b1c097af YW |
161 | |
162 | int sd_device_monitor_filter_add_match_subsystem_devtype(sd_device_monitor *m, const char *subsystem, const char *devtype); | |
163 | int sd_device_monitor_filter_add_match_tag(sd_device_monitor *m, const char *tag); | |
d9b030b6 | 164 | int sd_device_monitor_filter_add_match_sysattr(sd_device_monitor *m, const char *sysattr, const char *value, int match); |
b8a0edbb | 165 | int sd_device_monitor_filter_add_match_parent(sd_device_monitor *m, sd_device *device, int match); |
b1c097af YW |
166 | int sd_device_monitor_filter_update(sd_device_monitor *m); |
167 | int sd_device_monitor_filter_remove(sd_device_monitor *m); | |
168 | ||
4afd3348 LP |
169 | _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_device, sd_device_unref); |
170 | _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_device_enumerator, sd_device_enumerator_unref); | |
b1c097af | 171 | _SD_DEFINE_POINTER_CLEANUP_FUNC(sd_device_monitor, sd_device_monitor_unref); |
4afd3348 | 172 | |
57fa1d09 TG |
173 | _SD_END_DECLARATIONS; |
174 | ||
175 | #endif |