XBPS-CREATE(1)

💅 XBPS-CREATE(1) — the xbps-create glow-up 🎀

okay so before we even start: this is a page from the General Commands Manual section, and it's all about xbps-create, the XBPS utility that makes binary packages. bestie, we're gonna build a package together and it's gonna be iconic ✨

---

🌸 NAME 🌸

xbps-create — the XBPS utility that creates binary packages. that's her whole job. she builds.

---

🦋 SYNOPSIS 🦋

xbps-create [OPTIONS] destdir

---

✨ DESCRIPTION ✨

so like, xbps-create takes the files chillin' in a directory and turns them into a full-on XBPS binary package. simple as that, no cap.

but — and this is the important part — the files inside that directory have to have the correct permissions and the correct location already. she's not gonna fix that for you, she's just gonna package it. 🙈

and the finished package's behaviour gets changed by passing multiple values in the options. it's giving "you are what you configure." so pick your flags wisely, okay?

---

💖 OPTIONS 💖

• -A, --architecture string — the target architecture for this package. required, like literally required, don't forget her. use noarch if the package doesn't contain any arch-dependent file. 🫶
• -B, --built-with string — the package builder string. free form, so you can just say whatever you want here.
• -C, --conflicts list — a list of package patterns this package should conflict with, separated by whitespaces. example: 'foo>=1.0 blah<1.0'.
• -c, --changelog string — the package changelog string. your lore, basically.
• -D, --dependencies list — a list of package patterns this package depends on, separated by whitespaces. example: 'foo>=1.0 blah-1.0_1'.
• -F, --config-files list — a list of configuration files this package provides, separated by whitespace.
• -G, --source-revisions string — sets a string with the git revisions of the sourcepkg that was used to build this binary package. it's set automatically by xbps-src, so you usually don't touch this one.
• -H, --homepage string — the package homepage string.
• -h, --help — show the help message. slay.
• -l, --license string — the package license.
• -M, --mutable-files list — a list of mutable files this package provides, separated by whitespaces.
• -m, --maintainer string — the package maintainer name and/or email contact. that's you, main character 👑
• -n, --pkgver string — the package name/version tuple, e.g: 'foo-1.0_1'.
• -P, --provides list — a list of virtual packages this package provides, separated by whitespaces. example: 'virtualpkg-9999 virtualpkg2-1.0_1'.
• -p, --preserve — if set, the package files will be preserved after being updated.
• -q, --quiet — enable quiet operation. shhh 🤫
• -R, --replaces list — a list of package patterns this package replaces, separated by whitespaces. example: 'foo>=1.0 blah>=2.0'.
• -r, --reverts list — a list of versions this package reverts, separated by whitespaces. example: '2.0_1 2.1_1'.
• -S, --long-desc string — a long description for this package.
• -s, --desc string — a short description for this package, one line with less than 80 characters. keep it cute and keep it short 💅
• -t, --tags list — a list of tags (categories) this package should be part of, separated by whitespaces. example: 'development nonfree'.
• -V, --version — show the version information.
• --alternatives list — a list of alternatives provided by this package, separated by whitespaces. example: 'group:symlink:target group2:symlink:target'. and listen — if symlink is a relative path, the symlink will be created relative to target. noted 📝
• --build-options string — a string containing the build options used in package.
• --compression none | gzip | bzip2 | xz | lz4 | zstd — set the binary package compression format. if unset, defaults to zstd. 🗜️
• --shlib-provides list — a list of provided shared libraries, separated by whitespaces. example: 'libfoo.so.2 libblah.so.1'.
• --shlib-requires list — a list of required shared libraries, separated by whitespaces. example: 'libz.so.1 libfoo.so.2'.
• --sourcepkg string — the pkgver of the sourcepkg that was used to build this binary package.

---

💀 EXIT STATUS 💀

if something goes wrong, a descriptive error message will be printed to stderr. so like, she tells you what happened. read it.

---

🌈 SEE ALSO 🌈

the whole friend group, honestly:

xbps-alternatives(1), xbps-checkvers(1), xbps-dgraph(1), xbps-digest(1), xbps-fbulk(1), xbps-fetch(1), xbps-install(1), xbps-pkgdb(1), xbps-query(1), xbps-reconfigure(1), xbps-remove(1), xbps-rindex(1), xbps-uchroot(1), xbps-uunshare(1), xbps.d(5)

---

🧚 AUTHORS 🧚

Juan Romero Pardines <xtraeme@gmail.com> — the legend who made this happen. we stan 🫶

---

🍓 BUGS 🍓

probably, honestly. but the author tries to make this not happen 😭. use it under your own responsibility and enjoy your life — that's the whole vibe, fr fr.

report bugs at https://github.com/void-linux/xbps/issues — go be helpful 💜

---

okay that's the whole page, bestie. go make some packages, and remember: -A is required, noarch exists for a reason, and less than 80 characters means less than 80 characters. mwah 💋

this edition of the page came from Debian, dated Feb 9, 2023 — xoxo, see you in the next manpage ✨