msantos/procket

This system is a low-level Erlang library for advanced network programming, providing direct access to Linux packet sockets, Berkeley Packet Filters (BPF), and raw Ethernet frame manipulation. It exposes modules for managing BPF devices, handling PF\_PACKET sockets, and performing system-level I/O control operations. The codebase also includes example programs demonstrating network namespace usage, ICMP messaging, and control data handling.

The library introduces new modules for advanced packet manipulation and system calls. The \bpf\ module provides functions to open BPF devices, retrieve attributes (such as buffer length, datalink type, and statistics), and apply BPF filters. The \packet\ module adds support for Linux PF\_PACKET sockets, enabling users to send and receive raw Ethernet frames, look up MAC addresses via ARP cache, and resolve interface names and indices. Additionally, \procket\_ioctl\ is added to calculate ioctl request macros at runtime for both Linux and BSD systems, and \procket\_mktmp\ provides utilities for creating temporary directories. These changes expand the library's capabilities for low-level network programming and device interaction.

src · high confidence

Added new example programs: \sniff.erl\ demonstrates using network namespaces to capture packets on specific interfaces; \icmp.erl\ and \icmp6.erl\ provide examples for sending and filtering ICMP and ICMPv6 echo requests; \sendmsg\_recvmsg\_echo.erl\ shows how to use \sendmsg\ and \recvmsg\ with control data. Additionally, the existing \echo.erl\ example was moved from the \src\ directory to \examples\, updated to accept protocol family and type options, and simplified to remove the \inet:setopts\ call.

examples · high confidence

Added new header files (bpf.hrl, packet.hrl, procket.hrl) that define BPF ioctl commands, packet socket options, and socket constants, while renaming and refactoring the previous mktmp module into include/ioctl.hrl to provide common ioctl macros.

include · high confidence

The project has migrated from a custom Makefile-based build process to Rebar3. This change updates the build configuration (rebar.config, rebar.lock) and build scripts (rebar.config.script) to use Rebar3 for compilation, dependency management, and tooling (dialyzer, ex\_doc). The legacy Emakefile and manual Makefile targets for C compilation and NIF building have been removed in favor of Rebar3's standard hooks. Users will now use Rebar3 commands (e.g., \rebar3 compile\) instead of the previous Makefile targets.

(repo-wide) · high confidence

The C source code in c\_src has been refactored to use stateless NIFs, replacing the previous stateful approach with a static buffer for socket paths and a new procket\_alloc resource type for memory management. The build system has been updated to a new Makefile that supports cross-compilation, handles architecture-specific flags (x86\_64, arm64, i686, i386), and compiles ancillary and command-line tools. Additionally, procket\_constants.h was added to map IP protocol constants, and fd\_recv/fd\_send were updated to use a union for control message buffers to fix alignment issues.

_c\src · medium confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 45 → 53 (+7.4)
• Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 91 → 95 (+4.7)
• Architecture 100 → 100 (+0.0)
• Maturity 50 → 59 (+9.1)
• Readiness 15 → 25 (+9.2)
• Security 100 → 100 (+0.0)

• Dependency hygiene not measured — dependency manifest found but not parsed for hygiene
• No exposed public API
• Off-boarding risk: anonymized user #1
• The README does not mention how to install or compile procket from source. (README.md)
• There is no dedicated USING IT or EXAMPLES section, so readers cannot quickly try the library. (README.md)
• TooManyMethods: procket (src/procket.erl)
• complexity unreadable for .erl, .hrl — churn × complexity hotspots could not be measured

• Documentation: no contributor guidance (README.md)
• Documentation: no installation or build instructions (README.md)
• Documentation: no usage examples (README.md)
• Duplicated block (27–30 lines × 2) (src/packet.erl)
• FixmeComment (src/bpf.erl)
• FixmeComment (src/bpf.erl)
• FixmeComment (src/bpf.erl)
• FixmeComment (src/bpf.erl)
• bpf.ctl (cognitive 21) (src/bpf.erl)
• bpf.ctl (cyclomatic 17) (src/bpf.erl)
• bpf.ctl (cyclomatic 20) (src/bpf.erl)

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

msantos/procket was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.