📖 ~4 min read • Source: FreeBSD VuXML
VuXML topic: Arti — Security issues related to circuit construction
Related CVEs: CVE-2024-35312 CVE-2024-35313
Upstream summary: Tor Project reports: When building anonymizing circuits to or from an onion service with 'lite' vanguards (the default) enabled, the circuit manager code would build the circuits with one hop too few. When 'full' vanguards are enabled, some circuits are supposed to be built with an extra hop to minimize the linkability of the guard nodes. In some circumstances, the circuit manager would build circuits with one hop too few, making it easier for an adversary to discover the L2
Table of contents
Symptom & Impact
On FreeBSD 14 hosts running arti, the vulnerable code is started by something else – a web or application server, or an on-demand supervisor such as inetd, xinetd or a socket-activated helper – rather than by a service of its own. Patching replaces the files on disk immediately, but a long-running parent that has already loaded them (PHP-FPM workers, an application server, a persistent worker pool) keeps serving the old code until it is recycled. Connection-per-process supervisors pick the fix up on the next connection, so the exposure window differs sharply between the two and is worth confirming rather than assuming. arti is started by a hosting server or an on-demand supervisor rather than by a unit of its own, so restart whatever launches it – not arti.
Environment & Reproduction
Reproduction targets FreeBSD 14. Confirm release, installed package, and capture baseline state:
freebsd-version -kru
uname -a
pkg info arti
pkg query "%n-%v" arti
pkg audit -F
service -e
Exercise the workload that uses arti while collecting:
tail -200 /var/log/messages
dmesg -a | tail -200
tail -200 /var/log/pkg.log
Root Cause Analysis
Root cause is tracked at FreeBSD VuXML. The FreeBSD ports security team shipped a corrective arti port revision; hosts on an outdated build remain exposed. Correlate package logs with system logs and kernel state to isolate the change that triggered the failure mode:
tail -500 /var/log/pkg.log
tail -500 /var/log/messages
sysctl kern.lastpid
sysctl kern.osreldate # numeric __FreeBSD_version, e.g. 1400097
Quick Triage
Run these checks on FreeBSD 14 to confirm the failure mode and current state of arti:
pkg version -v arti # installed vs available version
pkg audit arti # advisory match for this package
tail -100 /var/log/messages
dmesg -a | tail -100
kldstat # kernel module state (for kernel/driver pkgs)
pfctl -sr 2>/dev/null || ipfw list # only if pf/ipfw is enabled
# e.g. bind918→named, php83→php-fpm), check it:
pkg query '%Fp' arti | sed -n 's|.*/etc/rc\.d/||p' # FreeBSD: the REAL service name(s) = basename of the rc.d script (bind918 -> named, postgresql16-server -> postgresql, apache24 -> apache24)
pkg query '%b' arti # FreeBSD: shared libraries PROVIDED by arti. Non-empty here + no rc.d script = it is a library: patch it, then restart its consumers
Step-by-Step Diagnosis
-
List enabled services (only relevant if the package provides one).
service -e -
Follow live logs.
tail -F /var/log/messages dmesg -
Validate firewall rules (skip if neither pf nor ipfw is enabled).
pfctl -sr -v 2>/dev/null || ipfw show -
Check package integrity for
arti.pkg check -B arti pkg check -d arti # verify shared-library deps -
Reinstall
artiif integrity check fails.pkg install -fy arti -
Correlate findings with
/var/log/pkg.logand FreeBSD VuXML to pin the commit that introduced the regression.
Solution – Primary Fix
Install the corrective arti port revision referenced by FreeBSD VuXML:
sudo pkg update
sudo pkg upgrade arti # or: sudo pkg upgrade -y for the whole system
pkg audit arti # confirm no remaining advisory for this package
For ports-tree builders (FreeBSD 13.x and earlier used portsnap; on FreeBSD 14+ the ports tree is fetched with Git):
# FreeBSD 14+ (portsnap was removed):
sudo pkg install -y git-lite
sudo git clone --depth 1 https://git.FreeBSD.org/ports.git /usr/ports
# FreeBSD 13.x and earlier:
# sudo portsnap fetch update
cd /usr/ports/<category>/arti
sudo make deinstall reinstall clean
Reboot only if the package ships a kernel module or replaces a shared library used by long-running daemons.
Need help rolling this patch across a FreeBSD fleet? Our IT Solutions & Services team manages FreeBSD jail/bhyve patch windows. Get in touch for a free consultation.
Solution – Alternative Approaches
If the primary fix is not viable, choose from these alternatives:
-
Lock the package until the fix is vetted:
sudo pkg lock arti -
Downgrade to a known-good revision.
pkg install pkgname-VERSIONis not a real downgrade syntax — fetch a specific build instead:# 1. Discover available versions across configured repos: pkg search -e arti pkg rquery -r FreeBSD-quarterly '%n-%v' arti # 2. Install from a specific saved .pkg file: sudo pkg add -f /path/to/arti-<older-version>.pkg # 3. Or switch the host repo to the quarterly branch (see snippet below) and: sudo pkg upgrade -fr FreeBSD-quarterly arti -
Switch the pkg repository between
quarterlyandlatestby editing/usr/local/etc/pkg/repos/FreeBSD.conf:FreeBSD: { url: "pkg+https://pkg.FreeBSD.org/${ABI}/quarterly", mirror_type: "srv", signature_type: "fingerprints", fingerprints: "/usr/share/keys/pkg", enabled: yes } -
Isolate the affected service in a jail with stricter firewall rules:
iocage create -n arti-jail -r 14.1-RELEASE iocage set allow_raw_sockets=0 arti-jail # or with Bastille: bastille create arti-jail 14.1-RELEASE 10.0.0.10 -
Replace the service with a vendored static build for the period between exposure detection and full rollout.
Verification & Acceptance Criteria
All of these should pass after the fix:
pkg info arti # shows the expected fixed version
pkg audit arti # no advisory for this package (exit code 0)
tail -50 /var/log/messages # no new errors after upgrade
# If arti ships a service, confirm it is running under its rc.d name:
The conditions described in the advisory must no longer be reported for arti across two consecutive runs.
Rollback Plan
Capture state before any change (only ZFS root has boot environments — UFS hosts skip bectl):
pkg query "%n-%v" > /root/pkg-pre.txt
# ZFS-on-root only:
sudo bectl create pre-arti-patch
To revert if the upgrade is bad, reinstall the previously saved .pkg file:
sudo pkg add -f /var/cache/pkg/arti-<previous-version>.pkg
# Or activate the pre-patch boot environment and reboot (ZFS-on-root only):
sudo bectl activate pre-arti-patch
sudo shutdown -r now
For kernel/loader changes on a UFS host, boot the previous kernel from the loader prompt (press 3 at the menu, then boot kernel.old).
Prevention & Hardening
Prevent recurrence on FreeBSD 14 hosts running arti:
-
Enable the daily security pkg audit in
/etc/periodic.conf:daily_status_security_pkgaudit_enable="YES" -
Subscribe to
freebsd-security-notificationsat lists.freebsd.org. -
Mirror through a local pkg repository managed by
poudriere:poudriere jail -c -j 14amd64 -v 14.1-RELEASE poudriere ports -c -p default poudriere bulk -j 14amd64 -p default <category>/arti -
Version-pin sensitive packages:
sudo pkg lock arti -
Take an automatic ZFS boot-environment snapshot before every upgrade (ZFS root only):
sudo bectl create pre-upgrade-$(date +%Y%m%d) -
Monitor file integrity (create a baseline, verify against it later):
# Create a baseline (use -c; target /usr/local/etc, /etc, /boot — NOT /): sudo mtree -c -K sha256digest -p /usr/local/etc > /var/db/usr-local-etc.mtree sudo mtree -c -K sha256digest -p /etc > /var/db/etc.mtree # Verify later: sudo mtree -p /usr/local/etc < /var/db/usr-local-etc.mtree # Or with AIDE for a richer ruleset: sudo pkg install -y aide && sudo aide --init && sudo aide --check -
Harden jails with
allow.*tunables in/etc/jail.conf:arti_jail { allow.raw_sockets = 0; allow.sysvipc = 0; allow.mount = 0; allow.chflags = 0; }
Related Errors & Cross-Refs
Issues that commonly surface alongside a arti update: pkg lock contention, mismatched ABI after kernel/userland skew, pf rule drift, and stale shared-library references after upgrade. Triage with:
freebsd-version -kru
uname -K
pkg check -d
pfctl -sr
View all freebsd-14 tutorials on the Tutorials Hub →
Browse all common problems & solutions on the Tutorials Hub.
References & Further Reading
Primary reference: FreeBSD VuXML. Useful manual pages on FreeBSD 14:
man pkg
man freebsd-update
man pfctl
man ipfw
man bectl
man periodic.conf
Other resources: the FreeBSD Handbook, the FreeBSD Security Advisories at security.freebsd.org, and the /usr/ports/UPDATING file for port-specific notes implicated in this advisory.