2020-11-09 05:23:58 +01:00
|
|
|
/* SPDX-License-Identifier: LGPL-2.1-or-later */
|
2008-08-27 17:11:58 +02:00
|
|
|
|
2015-10-24 22:58:24 +02:00
|
|
|
#include <ctype.h>
|
|
|
|
#include <stdarg.h>
|
|
|
|
#include <stddef.h>
|
2008-08-27 17:11:58 +02:00
|
|
|
#include <stdio.h>
|
|
|
|
#include <stdlib.h>
|
|
|
|
|
2015-11-17 06:52:45 +01:00
|
|
|
#include "libudev.h"
|
|
|
|
|
2015-10-27 03:01:06 +01:00
|
|
|
#include "alloc-util.h"
|
2015-10-25 13:14:12 +01:00
|
|
|
#include "fd-util.h"
|
2015-10-24 22:58:24 +02:00
|
|
|
#include "string-util.h"
|
2008-08-27 17:11:58 +02:00
|
|
|
|
2009-06-15 17:09:43 +02:00
|
|
|
/**
|
|
|
|
* SECTION:libudev
|
|
|
|
* @short_description: libudev context
|
|
|
|
*/
|
|
|
|
|
2009-06-15 13:22:38 +02:00
|
|
|
/**
|
|
|
|
* udev:
|
|
|
|
*
|
2009-06-15 17:09:43 +02:00
|
|
|
* Opaque object representing the library context.
|
2009-06-15 13:22:38 +02:00
|
|
|
*/
|
2008-08-28 23:05:01 +02:00
|
|
|
struct udev {
|
2018-08-28 06:07:48 +02:00
|
|
|
unsigned n_ref;
|
2012-01-10 01:34:15 +01:00
|
|
|
void *userdata;
|
2008-08-28 23:05:01 +02:00
|
|
|
};
|
|
|
|
|
2009-06-15 13:22:38 +02:00
|
|
|
/**
|
|
|
|
* udev_get_userdata:
|
|
|
|
* @udev: udev library context
|
|
|
|
*
|
|
|
|
* Retrieve stored data pointer from library context. This might be useful
|
2014-11-13 13:11:04 +01:00
|
|
|
* to access from callbacks.
|
2009-06-15 13:22:38 +02:00
|
|
|
*
|
|
|
|
* Returns: stored userdata
|
|
|
|
**/
|
2014-11-13 13:11:04 +01:00
|
|
|
_public_ void *udev_get_userdata(struct udev *udev) {
|
2018-08-28 06:15:03 +02:00
|
|
|
assert_return(udev, NULL);
|
|
|
|
|
2012-01-10 01:34:15 +01:00
|
|
|
return udev->userdata;
|
2008-09-25 06:39:29 +02:00
|
|
|
}
|
|
|
|
|
2009-06-15 13:22:38 +02:00
|
|
|
/**
|
|
|
|
* udev_set_userdata:
|
|
|
|
* @udev: udev library context
|
|
|
|
* @userdata: data pointer
|
|
|
|
*
|
|
|
|
* Store custom @userdata in the library context.
|
|
|
|
**/
|
2014-11-13 13:11:04 +01:00
|
|
|
_public_ void udev_set_userdata(struct udev *udev, void *userdata) {
|
2018-08-28 06:15:03 +02:00
|
|
|
if (!udev)
|
2012-01-10 01:34:15 +01:00
|
|
|
return;
|
2018-08-28 06:15:03 +02:00
|
|
|
|
2012-01-10 01:34:15 +01:00
|
|
|
udev->userdata = userdata;
|
2008-09-25 06:39:29 +02:00
|
|
|
}
|
|
|
|
|
2008-08-27 17:11:58 +02:00
|
|
|
/**
|
|
|
|
* udev_new:
|
|
|
|
*
|
2018-03-10 11:02:18 +01:00
|
|
|
* Create udev library context. This only allocates the basic data structure.
|
2008-08-27 17:11:58 +02:00
|
|
|
*
|
|
|
|
* The initial refcount is 1, and needs to be decremented to
|
2008-10-26 15:48:48 +01:00
|
|
|
* release the resources of the udev library context.
|
2008-08-27 17:11:58 +02:00
|
|
|
*
|
|
|
|
* Returns: a new udev library context
|
|
|
|
**/
|
2014-11-13 13:11:04 +01:00
|
|
|
_public_ struct udev *udev_new(void) {
|
2012-01-10 01:34:15 +01:00
|
|
|
struct udev *udev;
|
|
|
|
|
2018-08-28 06:14:42 +02:00
|
|
|
udev = new(struct udev, 1);
|
2018-11-21 06:06:41 +01:00
|
|
|
if (!udev)
|
|
|
|
return_with_errno(NULL, ENOMEM);
|
2018-08-28 06:14:42 +02:00
|
|
|
|
|
|
|
*udev = (struct udev) {
|
|
|
|
.n_ref = 1,
|
|
|
|
};
|
2012-01-10 01:34:15 +01:00
|
|
|
|
|
|
|
return udev;
|
2008-08-27 17:11:58 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* udev_ref:
|
|
|
|
* @udev: udev library context
|
|
|
|
*
|
|
|
|
* Take a reference of the udev library context.
|
|
|
|
*
|
|
|
|
* Returns: the passed udev library context
|
|
|
|
**/
|
2018-08-28 06:07:48 +02:00
|
|
|
DEFINE_PUBLIC_TRIVIAL_REF_FUNC(struct udev, udev);
|
2008-08-27 17:11:58 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* udev_unref:
|
|
|
|
* @udev: udev library context
|
|
|
|
*
|
|
|
|
* Drop a reference of the udev library context. If the refcount
|
2008-10-26 15:48:48 +01:00
|
|
|
* reaches zero, the resources of the context will be released.
|
2008-08-27 17:11:58 +02:00
|
|
|
*
|
2012-05-15 23:44:28 +02:00
|
|
|
* Returns: the passed udev library context if it has still an active reference, or #NULL otherwise.
|
2008-08-27 17:11:58 +02:00
|
|
|
**/
|
2014-11-13 13:11:04 +01:00
|
|
|
_public_ struct udev *udev_unref(struct udev *udev) {
|
2018-08-28 06:07:48 +02:00
|
|
|
if (!udev)
|
2012-05-15 22:57:58 +02:00
|
|
|
return NULL;
|
2018-08-28 06:07:48 +02:00
|
|
|
|
|
|
|
assert(udev->n_ref > 0);
|
|
|
|
udev->n_ref--;
|
|
|
|
if (udev->n_ref > 0)
|
2020-04-21 20:46:53 +02:00
|
|
|
/* This is different from our convention, but let's keep backward
|
2018-08-28 06:07:48 +02:00
|
|
|
* compatibility. So, do not use DEFINE_PUBLIC_TRIVIAL_UNREF_FUNC()
|
|
|
|
* macro to define this function. */
|
2012-05-15 22:57:58 +02:00
|
|
|
return udev;
|
2018-08-28 06:07:48 +02:00
|
|
|
|
2017-11-24 11:31:49 +01:00
|
|
|
return mfree(udev);
|
2008-08-27 17:11:58 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* udev_set_log_fn:
|
|
|
|
* @udev: udev library context
|
2014-11-01 19:33:01 +01:00
|
|
|
* @log_fn: function to be called for log messages
|
2008-08-27 17:11:58 +02:00
|
|
|
*
|
2014-11-13 13:11:04 +01:00
|
|
|
* This function is deprecated.
|
2008-08-27 17:11:58 +02:00
|
|
|
*
|
|
|
|
**/
|
2018-08-28 06:15:03 +02:00
|
|
|
_public_ void udev_set_log_fn(
|
|
|
|
struct udev *udev,
|
|
|
|
void (*log_fn)(struct udev *udev,
|
|
|
|
int priority, const char *file, int line, const char *fn,
|
|
|
|
const char *format, va_list args)) {
|
2014-11-13 13:11:04 +01:00
|
|
|
return;
|
2008-09-06 15:45:31 +02:00
|
|
|
}
|
|
|
|
|
2009-06-15 13:22:38 +02:00
|
|
|
/**
|
|
|
|
* udev_get_log_priority:
|
|
|
|
* @udev: udev library context
|
|
|
|
*
|
2014-11-13 13:11:04 +01:00
|
|
|
* This function is deprecated.
|
2009-06-15 13:22:38 +02:00
|
|
|
*
|
|
|
|
**/
|
2014-11-13 13:11:04 +01:00
|
|
|
_public_ int udev_get_log_priority(struct udev *udev) {
|
|
|
|
return log_get_max_level();
|
2008-09-06 15:45:31 +02:00
|
|
|
}
|
|
|
|
|
2009-06-15 13:22:38 +02:00
|
|
|
/**
|
|
|
|
* udev_set_log_priority:
|
|
|
|
* @udev: udev library context
|
2014-11-01 19:33:01 +01:00
|
|
|
* @priority: the new log priority
|
2009-06-15 13:22:38 +02:00
|
|
|
*
|
2014-11-13 13:11:04 +01:00
|
|
|
* This function is deprecated.
|
|
|
|
*
|
2009-06-15 13:22:38 +02:00
|
|
|
**/
|
2014-11-13 13:11:04 +01:00
|
|
|
_public_ void udev_set_log_priority(struct udev *udev, int priority) {
|
|
|
|
log_set_max_level(priority);
|
2008-09-06 15:45:31 +02:00
|
|
|
}
|