Files
2026-03-10 19:14:51 -07:00

79 lines
2.3 KiB
Plaintext

.TH AGE-VERIFICATION-DAEMON 8 "2026-03-10" "age-verification-services 0.1.0"
.SH NAME
age-verification-daemon \- D-Bus daemon implementing org.freedesktop.AgeVerification1
.SH SYNOPSIS
.B age-verification-daemon
.SH DESCRIPTION
.B age-verification-daemon
is a system D-Bus service that implements the
.B org.freedesktop.AgeVerification1
interface, providing age bracket data to application stores and OS-level
services in compliance with California SB-976 and similar legislation.
.PP
The daemon runs as root and stores age bracket data in
.I /var/lib/age-verification/ages.conf
(owned by root, mode 0600). Only the age bracket integer (1\(en4) is
stored, never a raw age value or date of birth.
.SH AGE BRACKETS
.TS
l l.
Bracket Meaning
1 Under 13 years old
2 13 to 15 years old (inclusive)
3 16 to 17 years old (inclusive)
4 18 years old or older
.TE
.SH D-BUS INTERFACE
The service is available on the system bus at:
.PP
.RS
Service: \fBorg.freedesktop.AgeVerification1\fR
.br
Object: \fB/org/freedesktop/AgeVerification1\fR
.RE
.SS Methods
.TP
.B SetAge(s user, u years)
Set the age for
.I user
in years. The age bracket is computed and stored; the raw value is discarded.
.TP
.B SetDateOfBirth(s user, s date)
Set the age for
.I user
from an ISO 8601 date string (\fIYYYY-MM-DD\fR).
The age bracket is computed and stored; the date is discarded.
.TP
.B GetAgeBracket(s user) \(-> u bracket
Return the age bracket (1\(en4) for
.IR user .
.SS Errors
.TP
.B org.freedesktop.AgeVerification1.Error.NoSuchUser
The specified user does not exist or is a system account.
.TP
.B org.freedesktop.AgeVerification1.Error.PermissionDenied
The caller is not root and is not querying their own account.
.TP
.B org.freedesktop.AgeVerification1.Error.InvalidDate
The date string passed to SetDateOfBirth is not a valid ISO 8601 date.
.TP
.B org.freedesktop.AgeVerification1.Error.AgeUndefined
No age has been configured for the specified user.
.SH FILES
.TP
.I /var/lib/age-verification/ages.conf
Local age bracket storage. Owned by root:root, mode 0600.
.TP
.I /usr/share/dbus-1/system.d/org.freedesktop.AgeVerification1.conf
D-Bus system policy file.
.TP
.I /lib/systemd/system/age-verification-daemon.service
systemd service unit.
.SH SEE ALSO
.BR age-verification-sync (1),
.BR dbus-send (1),
.BR systemctl (1)
.SH AUTHORS
Seth Olivarez <me@oxmc.me>