vasilito
f31522130f
Build system (5 gaps hardened): - COOKBOOK_OFFLINE defaults to true (fork-mode) - normalize_patch handles diff -ruN format - New 'repo validate-patches' command (25/25 relibc patches) - 14 patched Qt/Wayland/display recipes added to protected list - relibc archive regenerated with current patch chain Boot fixes (fixable): - Full ISO EFI partition: 16 MiB → 1 MiB (matches mini, BIOS hardcoded 2 MiB offset) - D-Bus system bus: absolute /usr/bin/dbus-daemon path (was skipped) - redbear-sessiond: absolute /usr/bin/redbear-sessiond path (was skipped) - daemon framework: silenced spurious INIT_NOTIFY warnings for oneshot_async services (P0-daemon-silence-init-notify.patch) - udev-shim: demoted INIT_NOTIFY warning to INFO (expected for oneshot_async) - relibc: comprehensive named semaphores (sem_open/close/unlink) replacing upstream todo!() stubs - greeterd: Wayland socket timeout 15s → 30s (compositor DRM wait) - greeter-ui: built and linked (header guard unification, sem_compat stubs removed) - mc: un-ignored in both configs, fixed glib/libiconv/pcre2 transitive deps - greeter config: removed stale keymapd dependency from display/greeter services - prefix toolchain: relibc headers synced, _RELIBC_STDLIB_H guard unified Unfixable (diagnosed, upstream): - i2c-hidd: abort on no-I2C-hardware (QEMU) — process::exit → relibc abort - kded6/greeter-ui: page fault 0x8 — Qt library null deref - Thread panics fd != -1 — Rust std library on Redox - DHCP timeout / eth0 MAC — QEMU user-mode networking - hwrngd/thermald — no hardware RNG/thermal in VM - live preload allocation — BIOS memory fragmentation, continues on demand
127 lines
4.5 KiB
XML
127 lines
4.5 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
|
|
<refentry id='dbusuuidgen1'>
|
|
|
|
<!-- dbus\-uuidgen manual page.
|
|
Copyright (C) 2006 Red Hat, Inc. -->
|
|
|
|
<refmeta>
|
|
<refentrytitle>dbus-uuidgen</refentrytitle>
|
|
<manvolnum>1</manvolnum>
|
|
<refmiscinfo class="manual">User Commands</refmiscinfo>
|
|
<refmiscinfo class="source">D-Bus</refmiscinfo>
|
|
<refmiscinfo class="version">@DBUS_VERSION@</refmiscinfo>
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname>dbus-uuidgen</refname>
|
|
<refpurpose>Utility to generate UUIDs</refpurpose>
|
|
</refnamediv>
|
|
<!-- body begins here -->
|
|
<refsynopsisdiv id='synopsis'>
|
|
<cmdsynopsis>
|
|
<command>dbus-uuidgen</command> <arg choice='opt'>--version </arg>
|
|
<arg choice='opt'><arg choice='plain'>--ensure </arg><arg choice='opt'><replaceable>=FILENAME</replaceable></arg></arg>
|
|
<arg choice='opt'><arg choice='plain'>--get </arg><arg choice='opt'><replaceable>=FILENAME</replaceable></arg></arg>
|
|
<sbr/>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
|
|
<refsect1 id='description'><title>DESCRIPTION</title>
|
|
<para>The <command>dbus-uuidgen</command> command generates or reads a universally unique ID.</para>
|
|
|
|
|
|
<para>Note that the D-Bus UUID has no relationship to RFC 4122 and does not generate
|
|
UUIDs compatible with that spec. Many systems have a separate command
|
|
for that (often called "uuidgen").</para>
|
|
|
|
|
|
<para>See <ulink url='https://www.freedesktop.org/wiki/Software/dbus/'>https://www.freedesktop.org/wiki/Software/dbus/</ulink> for more information
|
|
about D-Bus.</para>
|
|
|
|
|
|
<para>The primary usage of <command>dbus-uuidgen</command> is to run in the post-install
|
|
script of a D-Bus package like this:</para>
|
|
<literallayout remap='.nf'>
|
|
dbus-uuidgen --ensure
|
|
</literallayout> <!-- .fi -->
|
|
|
|
|
|
<para>This will ensure that /var/lib/dbus/machine-id exists and has the uuid in it.
|
|
It won't overwrite an existing uuid, since this id should remain fixed
|
|
for a single machine until the next reboot at least.</para>
|
|
|
|
|
|
<para>The important properties of the machine UUID are that 1) it remains
|
|
unchanged until the next reboot and 2) it is different for any two
|
|
running instances of the OS kernel. That is, if two processes see the
|
|
same UUID, they should also see the same shared memory, UNIX domain
|
|
sockets, local X displays, localhost.localdomain resolution, process
|
|
IDs, and so forth.</para>
|
|
|
|
|
|
<para>If you run <command>dbus-uuidgen</command> with no options it just prints a new uuid made
|
|
up out of thin air.</para>
|
|
|
|
|
|
<para>If you run it with --get, it prints the machine UUID by default, or
|
|
the UUID in the specified file if you specify a file.</para>
|
|
|
|
|
|
<para>If you try to change an existing machine-id on a running system, it will
|
|
probably result in bad things happening. Don't try to change this file. Also,
|
|
don't make it the same on two different systems; it needs to be different
|
|
anytime there are two different kernels running.</para>
|
|
|
|
|
|
<para>The UUID should be different on two different virtual machines,
|
|
because there are two different kernels.</para>
|
|
|
|
</refsect1>
|
|
|
|
<refsect1 id='options'><title>OPTIONS</title>
|
|
<para>The following options are supported:</para>
|
|
<variablelist remap='TP'>
|
|
<varlistentry>
|
|
<term><option>--get[=FILENAME]</option></term>
|
|
<listitem>
|
|
<para>If a filename is not given, defaults to localstatedir/lib/dbus/machine-id
|
|
(localstatedir is usually /var). If this file exists and is valid, the
|
|
uuid in the file is printed on stdout. Otherwise, the command exits
|
|
with a nonzero status.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><option>--ensure[=FILENAME]</option></term>
|
|
<listitem>
|
|
<para>If a filename is not given, defaults to localstatedir/lib/dbus/machine-id
|
|
(localstatedir is usually /var). If this file exists then it will be
|
|
validated, and a failure code returned if it contains the wrong thing.
|
|
If the file does not exist, it will be created with a new uuid in it.
|
|
On success, prints no output.</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><option>--version</option></term>
|
|
<listitem>
|
|
<para>Print the version of dbus-uuidgen</para>
|
|
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsect1>
|
|
|
|
<refsect1 id='author'><title>AUTHOR</title>
|
|
<para>See <ulink url='https://dbus.freedesktop.org/doc/AUTHORS'>https://dbus.freedesktop.org/doc/AUTHORS</ulink></para>
|
|
|
|
</refsect1>
|
|
|
|
<refsect1 id='bugs'><title>BUGS</title>
|
|
<para>Please send bug reports to the D-Bus mailing list or bug tracker,
|
|
see <ulink url='https://www.freedesktop.org/wiki/Software/dbus/'>https://www.freedesktop.org/wiki/Software/dbus/</ulink></para>
|
|
</refsect1>
|
|
</refentry>
|