picnoir/Systemd
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
Systemd/udev/lib/libudev-private.h

184 lines
10 KiB
C
Raw Normal View History

libudev: add library to access udev information
2008-08-27 17:11:58 +02:00
/*
* libudev - interface to udev device information
*
* Copyright (C) 2008 Kay Sievers <kay.sievers@vrfy.org>
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef _LIBUDEV_PRIVATE_H_
#define _LIBUDEV_PRIVATE_H_
use libudev code, unify logging, pass udev context around everywhere
2008-09-06 15:45:31 +02:00
#include <syslog.h>
libudev: add library to access udev information
2008-08-27 17:11:58 +02:00
#include "libudev.h"
libudev: device - add get_envp() to construct envp from property list
2008-10-15 14:21:33 +02:00
#define ARRAY_SIZE(x) (sizeof(x) / sizeof((x)[0]))
allow compiler to check dbg() arguments on non-debug builds Signed-off-by: Alan Jenkins <alan-jenkins@tuffmail.co.uk>
2008-09-29 18:50:21 +02:00
static inline void __attribute__ ((format(printf, 2, 3)))
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
udev_log_null(struct udev *udev, const char *format, ...) {}
allow compiler to check dbg() arguments on non-debug builds Signed-off-by: Alan Jenkins <alan-jenkins@tuffmail.co.uk>
2008-09-29 18:50:21 +02:00
libudev: add library to access udev information
2008-08-27 17:11:58 +02:00
#ifdef USE_LOG
libudev: fix --enable-debug
2008-10-05 16:18:21 +02:00
# ifdef DEBUG
libudev: device_init() -> device_new()
2008-09-30 16:16:29 +02:00
# define dbg(udev, arg...) udev_log(udev, LOG_DEBUG, __FILE__, __LINE__, __FUNCTION__, ## arg)
# else
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
# define dbg(udev, arg...) udev_log_null(udev, ## arg)
libudev: device_init() -> device_new()
2008-09-30 16:16:29 +02:00
# endif
# define info(udev, arg...) udev_log(udev, LOG_INFO, __FILE__, __LINE__, __FUNCTION__, ## arg)
# define err(udev, arg...) udev_log(udev, LOG_ERR, __FILE__, __LINE__, __FUNCTION__, ## arg)
use libudev code, unify logging, pass udev context around everywhere
2008-09-06 15:45:31 +02:00
#else
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
# define dbg(udev, arg...) udev_log_null(udev, ## arg)
# define info(udev, arg...) udev_log_null(udev, ## arg)
# define err(udev, arg...) udev_log_null(udev, ## arg)
use libudev code, unify logging, pass udev context around everywhere
2008-09-06 15:45:31 +02:00
#endif
libudev: add library to access udev information
2008-08-27 17:11:58 +02:00
use libudev code, unify logging, pass udev context around everywhere
2008-09-06 15:45:31 +02:00
/* libudev */
libudev: add library to access udev information
2008-08-27 17:11:58 +02:00
void udev_log(struct udev *udev,
int priority, const char *file, int line, const char *fn,
const char *format, ...)
__attribute__ ((format(printf, 6, 7)));
libudev: device_init() -> device_new()
2008-09-30 16:16:29 +02:00
extern struct udev_device *device_new(struct udev *udev);
use libudev code, unify logging, pass udev context around everywhere
2008-09-06 15:45:31 +02:00
extern const char *udev_get_rules_path(struct udev *udev);
extern int udev_get_run(struct udev *udev);
libudev: add global property list
2008-10-16 13:51:29 +02:00
extern struct udev_list_entry *udev_add_property(struct udev *udev, const char *key, const char *value);
extern struct udev_list_entry *udev_get_properties_list_entry(struct udev *udev);
libudev: add udev_device_get_syspath()
2008-09-01 18:52:22 +02:00
/* libudev-device */
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
extern int udev_device_set_syspath(struct udev_device *udev_device, const char *syspath);
extern int udev_device_set_subsystem(struct udev_device *udev_device, const char *subsystem);
libudev: device - add devtype support
2009-01-02 04:14:47 +01:00
extern int udev_device_set_devtype(struct udev_device *udev_device, const char *devtype);
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
extern int udev_device_set_devnode(struct udev_device *udev_device, const char *devnode);
extern int udev_device_add_devlink(struct udev_device *udev_device, const char *devlink);
libudev: device - add get_envp() to construct envp from property list
2008-10-15 14:21:33 +02:00
extern void udev_device_cleanup_devlinks_list(struct udev_device *udev_device);
libudev: handle ! in sysname, add sysnum, return allocated list_entry on add
2008-10-14 19:53:47 +02:00
extern struct udev_list_entry *udev_device_add_property(struct udev_device *udev_device, const char *key, const char *value);
extern struct udev_list_entry *udev_device_add_property_from_string(struct udev_device *udev_device, const char *property);
libudev: device - add get_envp() to construct envp from property list
2008-10-15 14:21:33 +02:00
extern char **udev_device_get_properties_envp(struct udev_device *udev_device);
libudev: monitor - cache result of monitor send buffer
2008-10-24 16:36:27 +02:00
extern ssize_t udev_device_get_properties_monitor_buf(struct udev_device *udev_device, const char **buf);
do not import the "uevent" file when we only read the db to get old symlinks
2008-11-05 12:23:06 +01:00
extern int udev_device_read_db(struct udev_device *udev_device);
libudev: update DEVLINKS property when properties are read
2008-10-15 16:56:06 +02:00
extern int udev_device_read_uevent_file(struct udev_device *udev_device);
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
extern int udev_device_set_action(struct udev_device *udev_device, const char *action);
extern int udev_device_set_driver(struct udev_device *udev_device, const char *driver);
extern const char *udev_device_get_devpath_old(struct udev_device *udev_device);
extern int udev_device_set_devpath_old(struct udev_device *udev_device, const char *devpath_old);
extern const char *udev_device_get_physdevpath(struct udev_device *udev_device);
extern int udev_device_set_physdevpath(struct udev_device *udev_device, const char *physdevpath);
extern int udev_device_get_timeout(struct udev_device *udev_device);
extern int udev_device_set_timeout(struct udev_device *udev_device, int timeout);
extern int udev_device_get_event_timeout(struct udev_device *udev_device);
extern int udev_device_set_event_timeout(struct udev_device *udev_device, int event_timeout);
extern int udev_device_set_devnum(struct udev_device *udev_device, dev_t devnum);
extern int udev_device_set_seqnum(struct udev_device *udev_device, unsigned long long int seqnum);
extern int udev_device_get_num_fake_partitions(struct udev_device *udev_device);
extern int udev_device_set_num_fake_partitions(struct udev_device *udev_device, int num);
extern int udev_device_get_devlink_priority(struct udev_device *udev_device);
extern int udev_device_set_devlink_priority(struct udev_device *udev_device, int prio);
extern int udev_device_get_ignore_remove(struct udev_device *udev_device);
extern int udev_device_set_ignore_remove(struct udev_device *udev_device, int ignore);
Allow watch handle to be stored in the udevdb.
2009-02-23 18:31:26 +01:00
extern int udev_device_get_watch_handle(struct udev_device *udev_device);
extern int udev_device_set_watch_handle(struct udev_device *udev_device, int handle);
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
extern void udev_device_set_info_loaded(struct udev_device *device);
libudev: add udev_device_get_syspath()
2008-09-01 18:52:22 +02:00
move udev_device_db to libudev
2008-10-16 17:30:06 +02:00
/* libudev-device-db-write.c */
extern int udev_device_update_db(struct udev_device *udev_device);
extern int udev_device_delete_db(struct udev_device *udev_device);
extern int udev_device_rename_db(struct udev_device *udev_device, const char *devpath);
libudev: add udev_monitor_send_device()
2008-10-09 23:38:30 +02:00
/* libudev-monitor - netlink/unix socket communication */
extern int udev_monitor_send_device(struct udev_monitor *udev_monitor, struct udev_device *udev_device);
libudev: monitor - add set_receive_buffer_size()
2008-10-17 16:49:27 +02:00
extern int udev_monitor_set_receive_buffer_size(struct udev_monitor *udev_monitor, int size);
libudev: add udev_monitor_send_device()
2008-10-09 23:38:30 +02:00
libudev: replace awkward callback list interfaces with list iterators
2008-09-25 13:20:27 +02:00
/* libudev-ctrl - daemon runtime setup */
move udev_ctrl to libudev-private
2008-09-08 17:59:00 +02:00
struct udev_ctrl;
extern struct udev_ctrl *udev_ctrl_new_from_socket(struct udev *udev, const char *socket_path);
extern int udev_ctrl_enable_receiving(struct udev_ctrl *uctrl);
extern struct udev_ctrl *udev_ctrl_ref(struct udev_ctrl *uctrl);
extern void udev_ctrl_unref(struct udev_ctrl *uctrl);
extern struct udev *udev_ctrl_get_udev(struct udev_ctrl *uctrl);
extern int udev_ctrl_get_fd(struct udev_ctrl *uctrl);
extern int udev_ctrl_send_set_log_level(struct udev_ctrl *uctrl, int priority);
extern int udev_ctrl_send_stop_exec_queue(struct udev_ctrl *uctrl);
extern int udev_ctrl_send_start_exec_queue(struct udev_ctrl *uctrl);
extern int udev_ctrl_send_reload_rules(struct udev_ctrl *uctrl);
udevadm: settle - synchronise with the udev daemon There's still a slight race condition when using udevadm settle, if the udev daemon has a pending inotify event but hasn't yet generated the "change" uevent for it, the kernel and udev sequence numbers will match and settle will exit. Now udevadm settle will send a control message to udevd, which will respond by sending SIGUSR1 back to the waiting udevadm settle once it has completed the main loop iteration in which it received the control message. If there were no pending inotify events, this will simply wake up the udev daemon and allow settle to continue. If there are pending inotify events, they are handled first in the main loop so when settle is continued they will have been turned into uevents and the kernel sequence number will have been incremented. Since the inotify event is pending for udevd when the close() system call returns (it's queued as part of the kernel handling for that system call), and since the kernel sequence number is incremented by writing to the uevent file (as udevd does), this solves the race. When the settle continues, if there were pending inotify events that udevd had not read, they are now pending uevents which settle can wait for. Signed-off-by: Scott James Remnant <scott@ubuntu.com>
2009-03-10 14:00:16 +01:00
extern int udev_ctrl_send_settle(struct udev_ctrl *uctrl);
move udev_ctrl to libudev-private
2008-09-08 17:59:00 +02:00
extern int udev_ctrl_send_set_env(struct udev_ctrl *uctrl, const char *key);
extern int udev_ctrl_send_set_max_childs(struct udev_ctrl *uctrl, int count);
struct udev_ctrl_msg;
extern struct udev_ctrl_msg *udev_ctrl_msg(struct udev_ctrl *uctrl);
extern struct udev_ctrl_msg *udev_ctrl_receive_msg(struct udev_ctrl *uctrl);
extern struct udev_ctrl_msg *udev_ctrl_msg_ref(struct udev_ctrl_msg *ctrl_msg);
extern void udev_ctrl_msg_unref(struct udev_ctrl_msg *ctrl_msg);
extern int udev_ctrl_get_set_log_level(struct udev_ctrl_msg *ctrl_msg);
extern int udev_ctrl_get_stop_exec_queue(struct udev_ctrl_msg *ctrl_msg);
extern int udev_ctrl_get_start_exec_queue(struct udev_ctrl_msg *ctrl_msg);
extern int udev_ctrl_get_reload_rules(struct udev_ctrl_msg *ctrl_msg);
udevadm: settle - synchronise with the udev daemon There's still a slight race condition when using udevadm settle, if the udev daemon has a pending inotify event but hasn't yet generated the "change" uevent for it, the kernel and udev sequence numbers will match and settle will exit. Now udevadm settle will send a control message to udevd, which will respond by sending SIGUSR1 back to the waiting udevadm settle once it has completed the main loop iteration in which it received the control message. If there were no pending inotify events, this will simply wake up the udev daemon and allow settle to continue. If there are pending inotify events, they are handled first in the main loop so when settle is continued they will have been turned into uevents and the kernel sequence number will have been incremented. Since the inotify event is pending for udevd when the close() system call returns (it's queued as part of the kernel handling for that system call), and since the kernel sequence number is incremented by writing to the uevent file (as udevd does), this solves the race. When the settle continues, if there were pending inotify events that udevd had not read, they are now pending uevents which settle can wait for. Signed-off-by: Scott James Remnant <scott@ubuntu.com>
2009-03-10 14:00:16 +01:00
extern pid_t udev_ctrl_get_settle(struct udev_ctrl_msg *ctrl_msg);
move udev_ctrl to libudev-private
2008-09-08 17:59:00 +02:00
extern const char *udev_ctrl_get_set_env(struct udev_ctrl_msg *ctrl_msg);
extern int udev_ctrl_get_set_max_childs(struct udev_ctrl_msg *ctrl_msg);
libudev: replace awkward callback list interfaces with list iterators
2008-09-25 13:20:27 +02:00
/* libudev-list */
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
struct udev_list_node {
struct udev_list_node *next, *prev;
libudev: rework list handling
2008-09-26 19:44:53 +02:00
};
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
extern void udev_list_init(struct udev_list_node *list);
libudev: make list_node functions available
2008-10-17 18:59:08 +02:00
extern int udev_list_is_empty(struct udev_list_node *list);
extern void udev_list_node_append(struct udev_list_node *new, struct udev_list_node *list);
extern void udev_list_node_remove(struct udev_list_node *entry);
#define udev_list_node_foreach(node, list) \
for (node = (list)->next; \
node != list; \
node = (node)->next)
#define udev_list_node_foreach_safe(node, tmp, list) \
for (node = (list)->next, tmp = (node)->next; \
node != list; \
node = tmp, tmp = (tmp)->next)
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
extern struct udev_list_entry *udev_list_entry_add(struct udev *udev, struct udev_list_node *list,
const char *name, const char *value,
int unique, int sort);
fix list handling in enumerate and rules file sorting
2008-11-04 20:19:01 +01:00
extern void udev_list_entry_delete(struct udev_list_entry *entry);
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
extern void udev_list_entry_remove(struct udev_list_entry *entry);
fix list handling in enumerate and rules file sorting
2008-11-04 20:19:01 +01:00
extern void udev_list_entry_insert_before(struct udev_list_entry *new, struct udev_list_entry *entry);
extern void udev_list_entry_append(struct udev_list_entry *new, struct udev_list_node *list);
udev_list_cleanup() -> udev_list_cleanup_entries()
2008-10-18 19:27:38 +02:00
extern void udev_list_cleanup_entries(struct udev *udev, struct udev_list_node *name_list);
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
extern struct udev_list_entry *udev_list_get_entry(struct udev_list_node *list);
libudev: list - add flag
2008-10-11 18:40:04 +02:00
extern int udev_list_entry_get_flag(struct udev_list_entry *list_entry);
extern void udev_list_entry_set_flag(struct udev_list_entry *list_entry, int flag);
udev-rules-parse: name_list -> udev_list
2008-10-16 20:12:16 +02:00
#define udev_list_entry_foreach_safe(entry, tmp, first) \
libudev: make list_node functions available
2008-10-17 18:59:08 +02:00
for (entry = first, tmp = udev_list_entry_get_next(entry); \
libudev: more list rework
2008-09-28 01:34:55 +02:00
entry != NULL; \
entry = tmp, tmp = udev_list_entry_get_next(tmp))
libudev: replace awkward callback list interfaces with list iterators
2008-09-25 13:20:27 +02:00
libudev: add queue interface
2008-10-01 09:34:07 +02:00
/* libudev-queue */
libudev: also prefix non-exported functions with udev_*
2008-10-09 22:24:43 +02:00
extern int udev_queue_export_udev_seqnum(struct udev_queue *udev_queue, unsigned long long int seqnum);
extern int udev_queue_export_device_queued(struct udev_queue *udev_queue, struct udev_device *udev_device);
extern int udev_queue_export_device_finished(struct udev_queue *udev_queue, struct udev_device *udev_device);
extern int udev_queue_export_device_failed(struct udev_queue *udev_queue, struct udev_device *udev_device);
libudev: add queue interface
2008-10-01 09:34:07 +02:00
libudev: add udev_device_get_syspath()
2008-09-01 18:52:22 +02:00
/* libudev-utils */
unify string replacement
2008-11-05 21:49:52 +01:00
#define UTIL_PATH_SIZE 1024
#define UTIL_LINE_SIZE 2048
#define UTIL_NAME_SIZE 512
#define UDEV_ALLOWED_CHARS_INPUT "/ $%?,"
libudev: switch API from devpath to syspath
2008-09-16 02:12:47 +02:00
extern ssize_t util_get_sys_subsystem(struct udev *udev, const char *syspath, char *subsystem, size_t size);
extern ssize_t util_get_sys_driver(struct udev *udev, const char *syspath, char *driver, size_t size);
extern int util_resolve_sys_link(struct udev *udev, char *syspath, size_t size);
libudev: get rid of udev_utils.c
2008-09-10 17:08:24 +02:00
extern int util_log_priority(const char *priority);
extern size_t util_path_encode(char *s, size_t len);
extern size_t util_path_decode(char *s);
extern void util_remove_trailing_chars(char *path, char c);
libudev: do not use any udev source file
2008-09-10 18:00:31 +02:00
extern size_t util_strlcpy(char *dst, const char *src, size_t size);
extern size_t util_strlcat(char *dst, const char *src, size_t size);
unify string replacement
2008-11-05 21:49:52 +01:00
extern int udev_util_replace_whitespace(const char *str, char *to, size_t len);
extern int udev_util_replace_chars(char *str, const char *white);
extern int udev_util_encode_string(const char *str, char *str_enc, size_t len);
libudev: add library to access udev information
2008-08-27 17:11:58 +02:00
#endif
Reference in a new issue Copy permalink