Hi, The afl-fuzz man page installed by the aflplusplus ebuild is badly damaged. For example: % man afl-fuzz | head afl-fuzz(8) System Manager’s Manual afl-fuzz(8) NAME afl-fuzz SYNOPSIS [1;93m[!] [1;97mWARNING: [0mPotentially mistyped AFL environ‐ ment variable: USE_EXPAND_IMPLICIT=ARCH ELIBC KERNEL, did you mean AFL_USE_EXPAND_IMPLICIT=ARCH ELIBC KERNEL?[0m (there is about about half a page of garbage in total, not all shown here). What seems to be happening is that the afl-fuzz program itself will barf ANSI rainbow vomit to standard output whenever it is run with any variables whose names begin with USE_ (including the underscore) in the environment. I guess the build system runs afl-fuzz to generate the man page and then just copies all that garbage straight into the generated troff code, control characters and all. Of course, the ebuild environment has many such variables defined so we end up with a half page of line noise. In order to get a (mostly) usable man page it suffices to unset the problematic vars when building (note that it is not enough to just set them to empty: they must be removed from the environment). Portage 3.0.63 (python 3.12.3-final-0, default/linux/amd64/17.1, gcc-13, glibc-2.39-r6, 6.1.99 x86_64) ================================================================= System uname: Linux-6.1.99-x86_64-Intel-R-_Core-TM-_i5-5200U_CPU_@_2.20GHz-with-glibc2.39 KiB Mem: 8059088 total, 81516 free KiB Swap: 4194300 total, 4192252 free Timestamp of repository gentoo: Thu, 15 Aug 2024 00:45:00 +0000 sh dash 0.5.12 ld GNU ld (Gentoo 2.40 p5) 2.40.0 ccache version 4.9.1 [enabled] app-misc/pax-utils: 1.3.7::gentoo app-shells/bash: 5.2_p26-r6::gentoo dev-build/autoconf: 2.13-r8::gentoo, 2.71-r7::gentoo dev-build/automake: 1.16.5-r2::gentoo dev-build/cmake: 3.28.5::gentoo dev-build/libtool: 2.4.7-r4::gentoo dev-build/make: 4.4.1-r1::gentoo dev-build/meson: 1.4.1::gentoo dev-lang/perl: 5.38.2-r3::gentoo dev-lang/python: 2.7.18_p16-r2::gentoo, 3.9.18::gentoo, 3.10.13::gentoo, 3.11.9-r1::gentoo, 3.12.3-r1::gentoo dev-lang/rust: 1.77.1::gentoo dev-lang/rust-bin: 1.77.1::gentoo dev-util/ccache: 4.9.1::gentoo sys-apps/baselayout: 2.15::gentoo sys-apps/openrc: 0.53::gentoo sys-apps/sandbox: 2.38::gentoo sys-devel/binutils: 2.40-r5::gentoo, 2.41-r5::gentoo, 2.42-r1::gentoo sys-devel/binutils-config: 5.5::gentoo sys-devel/clang: 13.0.1::gentoo, 14.0.6-r1::gentoo, 15.0.7-r3::gentoo, 16.0.6::gentoo, 17.0.6::gentoo sys-devel/gcc: 9.5.0::gentoo, 11.4.1_p20240111::gentoo, 12.3.1_p20240209::gentoo, 13.2.1_p20240210::gentoo sys-devel/gcc-config: 2.11::gentoo sys-devel/lld: 14.0.6-r1::gentoo, 15.0.7::gentoo sys-devel/llvm: 13.0.1::gentoo, 14.0.6-r2::gentoo, 15.0.7-r3::gentoo, 16.0.6::gentoo, 17.0.6::gentoo sys-kernel/linux-headers: 6.9::gentoo (virtual/os-headers) sys-libs/glibc: 2.39-r6::gentoo Repositories: gentoo location: /srv/repos/gentoo sync-type: squashmirror sync-uri: /srv/gentoo sync-user: root priority: -1000 volatile: True squash-compression: xz squash-cache-location: /var/cache/portage squash-extra-opts: -e distfiles -e packages -e local gentoo-draconx location: /srv/repos/gentoo-draconx sync-type: null sync-uri: null masters: gentoo volatile: True gentoo-fixes location: /srv/repos/gentoo-fixes sync-type: null sync-uri: null masters: gentoo volatile: True ACCEPT_KEYWORDS="amd64" ACCEPT_LICENSE="@FREE @OTHER-FREE" CBUILD="x86_64-pc-linux-gnu" CFLAGS="-O2 -march=broadwell -pipe" CHOST="x86_64-pc-linux-gnu" CONFIG_PROTECT="/etc /usr/share/gnupg/qualified.txt" CONFIG_PROTECT_MASK="/etc/ca-certificates.conf /etc/dconf /etc/env.d /etc/fonts/fonts.conf /etc/gconf /etc/gentoo-release /etc/revdep-rebuild /etc/sandbox.d /etc/terminfo /etc/texmf/language.dat.d /etc/texmf/language.def.d /etc/texmf/updmap.d /etc/texmf/web2c" CXXFLAGS="-O2 -march=broadwell -pipe" DISTDIR="/var/cache/portage/distfiles" EMERGE_DEFAULT_OPTS="-j3 --keep-going --dynamic-deps=n --autounmask=n --autounmask-write=n --unordered-display --verbose-conflicts --binpkg-respect-use=y --with-bdeps-auto=n" ENV_UNSET="CARGO_HOME DBUS_SESSION_BUS_ADDRESS DISPLAY GDK_PIXBUF_MODULE_FILE GOBIN GOPATH PERL5LIB PERL5OPT PERLPREFIX PERL_CORE PERL_MB_OPT PERL_MM_OPT XAUTHORITY XDG_CACHE_HOME XDG_CONFIG_HOME XDG_DATA_HOME XDG_RUNTIME_DIR XDG_STATE_HOME" FCFLAGS="-O2 -march=broadwell -pipe" FEATURES="assume-digests binpkg-docompress binpkg-dostrip binpkg-logs binpkg-multi-instance buildpkg-live ccache config-protect-if-modified distlocks ebuild-locks fixlafiles ipc-sandbox merge-sync merge-wait multilib-strict network-sandbox news parallel-fetch pid-sandbox pkgdir-index-trusted preserve-libs protect-owned qa-unresolved-soname-deps sandbox sfperms strict unknown-features-warn unmerge-logs unmerge-orphans userfetch userpriv usersandbox usersync xattr" FFLAGS="-O2 -march=broadwell -pipe" GENTOO_MIRRORS="http://distfiles.gentoo.org" INSTALL_MASK="/usr/share/cursors/xorg-x11/default /usr/share/alsa/alsa.conf.d/*.conf /etc/alsa/conf.d/*.conf /etc/portage/*postsync.d /etc/gssproxy/??-*.conf /etc/profile.d/qtgui4.sh /etc/????.d/wpa_supplicant" LANG="en_CA.UTF-8" LDFLAGS="-Wl,-O1 -Wl,--as-needed" LEX="flex" MAKEOPTS="-j4 -l5" PKGDIR="/var/cache/portage/packages" PORTAGE_CONFIGROOT="/" PORTAGE_RSYNC_OPTS="--recursive --links --safe-links --perms --times --omit-dir-times --compress --force --whole-file --delete --stats --human-readable --timeout=180 --exclude=/distfiles --exclude=/local --exclude=/packages --exclude=/.git" PORTAGE_TMPDIR="/var/tmp" SHELL="/bin/zsh" USE="X aacs acl alsa amd64 bluray bs2b bzip2 cairo cdda cjk cli crypt cups dav1d doc dri dts dv exif fbcon flac fontconfig fortran gdbm gpm gtk gtk-doc iconv icu idn ipv6 jpeg jpeg2k kerberos libtirpc mp3 multilib ncurses nls ogg opencl opengl openmp opus pam pango pcre perl png python readline seccomp smp split-usr ssl svg test-rust theora threads tiff truetype unicode vaapi vim-syntax vorbis vulkan webp xattr xft xinerama zlib" ABI_X86="64" ADA_TARGET="gcc_12" APACHE2_MODULES="authn_core authz_core socache_shmcb unixd actions alias auth_basic authn_anon authn_dbm authn_file authz_dbm authz_groupfile authz_host authz_owner authz_user autoindex cache cgi cgid dav dav_fs dav_lock deflate dir env expires ext_filter file_cache filter headers include info log_config logio mime mime_magic negotiation rewrite setenvif speling status unique_id userdir usertrack vhost_alias" CALLIGRA_FEATURES="karbon sheets words" COLLECTD_PLUGINS="df interface irq load memory rrdtool swap syslog" CPU_FLAGS_X86="aes avx avx2 f16c fma3 mmx mmxext pclmul popcnt rdrand sse sse2 sse3 sse4_1 sse4_2 ssse3" ELIBC="glibc" GPSD_PROTOCOLS="ashtech aivdm earthmate evermore fv18 garmin garmintxt gpsclock greis isync itrax mtk3301 ntrip navcom oceanserver oncore rtcm104v2 rtcm104v3 sirf skytraq superstar2 tsip tripmate tnt ublox" KERNEL="linux" LCD_DEVICES="bayrad cfontz glk hd44780 lb216 lcdm001 mtxorb text" LUA_SINGLE_TARGET="lua5-1" LUA_TARGETS="lua5-1" OFFICE_IMPLEMENTATION="libreoffice" PHP_TARGETS="php8-2" POSTGRES_TARGETS="postgres15" PYTHON_SINGLE_TARGET="python3_12" PYTHON_TARGETS="python3_12" RUBY_TARGETS="ruby31 ruby32" VIDEO_CARDS="intel i965 iris" XTABLES_ADDONS="quota2 psd pknock lscan length2 ipv4options ipp2p iface geoip fuzzy condition tarpit sysrq proto logmark ipmark dhcpmac delude chaos account" Unset: ADDR2LINE, AR, ARFLAGS, AS, ASFLAGS, CC, CCLD, CONFIG_SHELL, CPP, CPPFLAGS, CTARGET, CXX, CXXFILT, ELFEDIT, EXTRA_ECONF, F77FLAGS, FC, GCOV, GPROF, LC_ALL, LD, LFLAGS, LIBTOOL, LINGUAS, MAKE, MAKEFLAGS, NM, OBJCOPY, OBJDUMP, PORTAGE_BINHOST, PORTAGE_BUNZIP2_COMMAND, PORTAGE_COMPRESS, PORTAGE_COMPRESS_FLAGS, PORTAGE_RSYNC_EXTRA_OPTS, PYTHONPATH, RANLIB, READELF, RUSTFLAGS, SIZE, STRINGS, STRIP, YACC, YFLAGS
Created attachment 903808 [details, diff] proposed patch with this applied, the line noise is gone.
Created attachment 903809 [details, diff] proposed patch (v2) Same as v1 but with corrected minor quoting mistake.
Thanks!
The bug has been closed via the following commit(s): https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=b57ec2cd26d3ca4951dbaad3ebdb3915d0c6e78c commit b57ec2cd26d3ca4951dbaad3ebdb3915d0c6e78c Author: Sam James <sam@gentoo.org> AuthorDate: 2024-10-05 02:08:42 +0000 Commit: Sam James <sam@gentoo.org> CommitDate: 2024-10-05 02:08:51 +0000 app-forensics/aflplusplus: fix man page Closes: https://bugs.gentoo.org/940252 Thanks-to: Nick Bowler <nbowler@draconx.ca> Signed-off-by: Sam James <sam@gentoo.org> app-forensics/aflplusplus/aflplusplus-4.08c-r1.ebuild | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-)
