PORTGEN(1)

💖 PORTGEN(1) — port modules on the fly 💖

okay so this is the PORTGEN(1) page from the General Commands Manual, and the main character is portgen, duh 💅 she ports modules on the fly and we’re obsessed.

🌸 NAME 🌸

portgen — port modules on the fly

🦋 SYNOPSIS 🦋

portgen [-m makeopt] type module-name

✨ DESCRIPTION ✨

okay so portgen is the utility that creates ports for the module-name you hand it, using the type module framework. It downloads the module, analyzes it, and translates it into a port — like a glow-up but for software 🫶. Any missing dependencies are handled recursively, no cap.

New ports will land under ${PORTSDIR}/mystuff. The PORTSDIR value will be taken from the current user environment, and defaults to /usr/ports. so if you don’t set it, she’s going to /usr/ports, periodt.

✨ the options are as follows, bestie: ✨

• -m makeopt — pass makeopt to make(1) invocations while resolving missing dependencies. This is mostly useful with ‘FETCH_PACKAGES=’ to avoid building everything from scratch. lowkey the move 💅

The portgen utility currently supports the following type values:

• p5 — for Perl modules on CPAN.
• ruby — for Ruby gems.
• go — for Go modules.

A go module may be used with an @version suffix to specify a tag or branch to port. The default suffix is @latest, which is interpreted as the latest release. iconic ✨

The following packages must be installed prior to the invocation of portgen:

• sqlports
• p5-DBI
• p5-DBD-SQLite

💀 EXIT STATUS 💀

The portgen utility exits 0 on success, and >0 if an error occurs. so 0 is the slay outcome, and anything >0 is the “something went off” vibe 😭

🍓 EXAMPLES 🍓

The following command will download the latest version of Config::AutoConf from CPAN, parse it and create a port for it:

portgen p5 Config::AutoConf

🧚 SEE ALSO 🧚

port-modules(5), ports(7) — go read those too, iykyk 💜

🌈 HISTORY 🌈

The portgen utility first appeared in OpenBSD 5.9 as a result of Google Summer of Code 2015. iconic origin story, fr fr 👑

🎀 AUTHORS 🎀

Giannis Tsaraias <tsg@openbsd.org>

🙈 CAVEATS 🙈

Not every module could be converted to a port. that’s just the tea, bestie 😭

---

and that’s the page! footer vibes: source/version Debian, date August 13, 2022, page PORTGEN(1) — mwah, bye bestie 💋💅✨