Commit Graph

741 Commits

Author SHA1 Message Date
Boian Bonev
9e7c4e744b
Commit the generated man page 2023-10-05 20:20:45 +03:00
Vivien Kraus
89a68e7c7e Clarify the /etc/udev/hwdb.d file override with respect to UDEV_HWDB_PATH
Overriding a file in /etc/udev/hwdb.d also hides the files with that
name in UDEV_HWDB_PATH.
2023-10-01 19:51:23 +02:00
Vivien Kraus
672cbb5742 Remove references to /run/udev/hwdb.d
This directory never seemed to exist. The wording is very similar to
that of the Rules Files section, so it is possible that the same text
was copied and pasted by mistake. The HWDB never looked for files in
/run.

Having a non-volatile index of volatile files would probably not be
useful.
2023-10-01 19:50:37 +02:00
Boian Bonev
02a2afffc1
Improve wording
Generate udevadm.8 from udevadm.xml
2023-09-30 22:35:38 +00:00
Boian Bonev
218489052f
Improve wording and restore lines lost in merges
Generate udev.7 from udev.xml
2023-09-30 22:29:22 +00:00
Boian Bonev
060dc0ffaf
Merge branch 'master' into master 2023-10-01 00:26:08 +03:00
Boian Bonev
701d83f686
Merge branch 'master' into udevadm-hwdb-update-output 2023-10-01 00:16:38 +03:00
Boian Bonev
5f98fb38c1
Merge branch 'master' into hwdb-bin-file-environment 2023-10-01 00:04:32 +03:00
Vivien Kraus
65e17b2f2f Dynamically get the udevadm hwdb files with a path variable
Introduce UDEV_HWDB_PATH, containing a colon-separated path with hwdb
files in it. The whole path is searched, in addition to the system
locations, when searching for hwdb files.

Due to how conf_files_list_strv is implemented, as a thin wrapper
around the internal function, it is easy to also implement a variant
accepting a search path in the same way. Since the internal function
expects an allocated array of allocated strings, the path scanning is
done in 2 steps, to first get the array length, and then duplicate the
items. It is not possible to use strtok(_r) here because it would work
for only 1 pass.

* src/shared/conf-files.c (conf_files_list_follow_path): New function.
(conf_files_list_strv_path): Use it here.
* src/shared/conf-files.h: Export the signature for the _path variant.
* src/udev/udevadm-hwdb.c (list_conf_file_path): New function
replacing conf_file_dirs.
(help): Document the search path for hwdb files.
(adm_hwdb): Use list_conf_file_path and conf_files_list_strv_path.
* man/udevadm.xml: Mention UDEV_HWDB_PATH.
* man/udev.xml: Same.
* man/udevadm.8: Regenerate.
* man/udev.7: Same.
2023-09-30 19:40:17 +02:00
Vivien Kraus
1eca0ef6c4 Add a generic --output argument to udevadm hwdb
Instead of always writing /etc/udev/hwdb.bin or UDEV_LIBEXEC_DIR
/hwdb.bin, let the user specify a full file name.

* src/udev/udevadm-hwdb.c (adm_hwdb): New option "output". Construct
hwdb_bin when processing options, and prepend root after processing
options.
* man/udev.xml: Mention --output.
* man/udevadm.xml: Document --output.
* man/udev.7: Regenerate.
* man/udevadm.8: Same.
2023-09-30 19:38:30 +02:00
Vivien Kraus
c7da117e5c Let libudev find hwdb.bin under UDEV_HWDB_BIN
* src/libudev/libudev-hwdb.c (get_hwdb_bin_paths): New function,
replacing hwdb_bin_paths.
(struct udev_hwdb): New bin_paths field.
(udev_hwdb_new): Initialize it with get_hwdb_bin_paths.
(udev_hwdb_validate): Use the bin_paths field to find hwdb.bin.
(udev_hwdb_unref): Free the bin_paths field.
* src/libudev/libudev.h: Warn about UDEV_HWDB_BIN.
* man/udev.xml: Mention run-time UDEV_HWDB_BIN.
* man/udev.7: Re-generate.
2023-09-30 19:36:55 +02:00
Boian Bonev
19aa81d9bf
Regenerate according to 0cf14fb and e5e4013 2023-09-30 16:55:44 +00:00
Boian Bonev
e5e4013cb7
Move the changes from udev.7 to udev.xml
Commit 0cf14fb changed only the generated udev.7 without touching the
source file udev.xml
2023-09-30 16:52:12 +00:00
omni
0cf14fbdce man: udev.7, mention /usr/lib with split-usr 2023-02-04 13:39:20 +00:00
Boian Bonev
49222bcc9c
Build and install hwdb.7 man page 2022-06-08 02:41:44 +03:00
Boian Bonev
f566c4ae32
Merge the generated man page 2022-06-06 16:30:50 +03:00
Boian Bonev
cd61841483
Merge pull request #223 from bbonev/precompiled_hwdb
Precompiled hwdb
2022-05-31 20:35:00 +03:00
Boian Bonev
b11e438970
udev hwdb: Support shipping pre-compiled database in system images
From: Martin Pitt <martin.pitt@ubuntu.com>
Date: Fri, 17 Oct 2014 15:01:01 +0200
Subject: udev hwdb: Support shipping pre-compiled database in system images

In some cases it is preferable to ship system images with a pre-generated
binary hwdb database, to avoid having to build it at runtime, avoid shipping
the source hwdb files, or avoid storing large binary files in /etc.

So if hwdb.bin does not exist in /etc/udev/, fall back to looking for it in
UDEVLIBEXECDIR. This keeps the possibility to add files to /etc/udev/hwdb.d/
and re-generating the database which trumps the one in /usr/lib.

Add a new --usr flag to "udevadm hwdb --update" which puts the database
into UDEVLIBEXECDIR.

Adjust systemd-udev-hwdb-update.service to not generate the file in /etc if we
already have it in /usr.
Anto:
2022-05-26 19:25:56 +03:00
Boian Bonev
ce9d0aadfb
Use reproducible man page generation 2022-05-26 19:16:16 +03:00
Boian Bonev
322765fe74
Copy the missing man page from systemd
The respective systemd commits are not listed
2022-05-26 19:16:16 +03:00
Boian Bonev
95ab90723d
Keep the reproducible generated man pages in git 2022-05-26 19:16:16 +03:00
Boian Bonev
f2128f5e49
Rework custom man page template from systemd
- remove the non-reproducible top.comment section from the generated man pages
- do not change the other aspects of man page contents
2022-05-26 19:16:13 +03:00
Boian Bonev
c23157fed2
Fix spelling 2022-04-06 03:39:43 +03:00
Boian Bonev
a8a0eb73f5
Print the commands in verbose builds 2021-10-04 22:04:20 +03:00
nnnn20430
6f630d32bf man: add short options to udevd.xml; update udev.7
short options which were added to the udevd manpage, were not added to
the .xml file, and everytime manpages get regenerated the change gets
overwritten.
also update pregenerated version of udev manpage

Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2018-03-10 23:49:12 -05:00
Marcus Folkesson
e3eb9433e7 man: add short options to manpage
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2017-12-05 08:46:06 -05:00
Marcus Folkesson
cb1cfc6c1b man: remove UDEV_LOG environment variable
Last time $UDEV_LOG was referred in code was in
dacd994fda.

Remove all traces for this legacy option.

Signed-off-by: Marcus Folkesson <marcus.folkesson@gmail.com>
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2017-12-05 08:45:57 -05:00
Anthony G. Basile
451bbdaa39 man/udev.xml: remove repeated section, gentoo bug #619434
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2017-09-04 20:49:25 -04:00
Anthony G. Basile
823db6f44c configure.ac bump 3.2.1
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2016-12-11 11:50:20 -05:00
Robby Workman
26b8f53163 Remove obsolete udev_root references
This was removed in 6ada823a9a
2015-11-15 15:11:13 -06:00
Anthony G. Basile
71640ee498 man: update
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2015-05-30 07:09:14 -04:00
Kay Sievers
b8adef56d8 udev: add SYSCTL{} support
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2015-03-18 20:33:17 -04:00
Anthony G. Basile
9d06e65608 man/udev.xml: restore hwdb documentation 2014-12-20 11:45:25 -05:00
Zbigniew Jędrzejewski-Szmek
62d9908a84 udevadm trigger: allow matching by device name
This makes udevadm trigger mirror udevadm info, except that multiple
device names can be specified. Instructions in 60-keyboard.hwdb should
now actually work.

udevadm(8) is updated, but it could use a bit more polishing.

https://bugs.freedesktop.org/show_bug.cgi?id=82311

Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-11-28 08:54:14 -05:00
Lennart Poettering
2694f4de06 man: add emacs header to get correct indention in nxml-mode for the manpage XML files that use 2ch indenting
In the long run we really should figure out if we want to stick with 8ch
or 2ch indenting, and not continue with half-and-half. For now, just
make emacs aware of the files that use 2ch indenting.

Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-11-27 08:29:53 -05:00
Anthony G. Basile
903c8a36e1 man/udev.conf.xml: fix s/commandline/command line/g and rebuild man pages
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-11-07 08:33:37 -05:00
Zbigniew Jędrzejewski-Szmek
c45f1f9002 man: describe all log levels in udevadm(8)
https://bugs.freedesktop.org/show_bug.cgi?id=85657

Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-11-02 14:44:51 -05:00
Anthony G. Basile
0ba3128e90 man: update man pages
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-11-02 14:36:05 -05:00
Zbigniew Jędrzejewski-Szmek
ad9c47a35b Use log "level" instead of "priority"
The term "priority" is misleading because higher levels have lower
priority. "Level" is clearer and shorter.

This commit touches only the textual descriptions, not function and variable
names themselves. "Priority" is used in various command-line switches and
protocol constants, so completly getting rid of "priority" is hard.

I also left "priority" in various places where the clarity suffered
when it was removed.

Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-11-02 14:27:23 -05:00
Anthony G. Basile
887305880a man/make.sh: die if /usr/bin/xsltproc is not found
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-11-01 13:22:24 -04:00
Anthony G. Basile
2886f6c9e5 man: change systemd-udev to udev everywhere
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-10-31 21:25:43 -04:00
Anthony G. Basile
96fe7e83d4 man: ship pre-build man pages
This addresses https://github.com/gentoo/eudev/issues/98

Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-10-31 20:12:39 -04:00
Anthony G. Basile
014ba30c45 man/udev.xml: update man page
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-10-30 21:55:57 -04:00
Zbigniew Jędrzejewski-Szmek
e5d31af2df man: make udev.event-timeout more visible
Evidently some people had trouble finding it in the documentation.

Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-10-25 11:32:18 -04:00
David Herrmann
ffdc02f45b udev: allow removing tags via TAG-="foobar"
This extends the udev parser to support OP_REMOVE (-=) and adds support
for TAG-= to remove previously set tags. We don't fail if the tag didn't
exist.

This is pretty handy if we ship default rules for seat-assignments and
users want to exclude specific devices from that. They can easily add
rules that drop any automatically added "seat" tags again.

Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-09-13 08:46:04 -04:00
Andrei Borzenkov
534b690568 Document "...|..." udev match syntax
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-08-27 21:41:14 -04:00
Zbigniew Jędrzejewski-Szmek
93bc913f14 man: add udev.conf(5)
We generally have separate man pages for all configuration files.
In this case udev.conf was already described in systemd-udevd.service(8),
but it was hard to find. Docbook makes it hard to add a .so link from
a different section, so describe udev.conf in its own page.

Signedaoff-by: Anthony G. Basile <blueness@gentoo.org>
2014-08-04 11:54:48 -04:00
Kay Sievers
471a5f3411 udev: unify event timeout handling
Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-07-30 09:31:38 -04:00
Kay Sievers
2500dbc810 udev: remove seqnum API and all assumptions about seqnums
The way the kernel namespaces have been implemented breaks assumptions
udev made regarding uevent sequence numbers. Creating devices in a
namespace "steals" uevents and its sequence numbers from the host. It
confuses the "udevadmin settle" logic, which might block until util a
timeout is reached, even when no uevent is pending.

Remove any assumptions about sequence numbers and deprecate libudev's
API exposing these numbers; none of that can reliably be used anymore
when namespaces are involved.

Signed-off-by: Anthony G. Basile <blueness@gentoo.org>
2014-04-24 15:40:08 -04:00
lhb-jr
8a5de44bb8 modified: configure.ac
modified:   man/Makefile.am
Added checking for DocBook in configure
2014-03-20 20:51:06 -04:00