XBPS-FETCH(1)

💅 xbps-fetch — the XBPS manual page, but make it cute

okay so bestie, welcome to xbps-fetch(1) from the General Commands Manual — this is the little XBPS utility that goes and grabs files off the internet for you. It's giving personal assistant, honestly. 🫶

---

✨ NAME ✨

xbps-fetch — XBPS utility to fetch files from URLs. That's it. That's the job. And it ate. 💅

---

🌸 SYNOPSIS 🌸

xbps-fetch [OPTIONS] <URL> <URL+N>

yeah so you give it a URL, and then you can give it more URLs, because why stop at one? slay. ✨

---

🦋 DESCRIPTION 🦋

The xbps-fetch utility downloads files from specified URLs. Multiple protocols are supported, and the lineup is literally: ftp, http, https, socks5. no cap, that's the whole roster. 🔥

---

🎀 OPTIONS 🎀

• -d — Enables debug messages on stderr. for when you need the lore. 👀
• -h — Show the help message. the "hey bestie what do I do" button.
• -o output — Rename file from specified URL to output. glow-up for your filename. 💖
• -v — Enables verbose messages. it will yap. affectionately.
• -s — Print sha256sums of downloaded files. receipts, but cryptographic. 🧚
• -V — Show the version information. who are you, what version, main character energy.

---

🌈 ENVIRONMENT 🌈

so this tool reads a whole bunch of environment variables and honestly? it's a lot. but every single one matters so buckle up. 🍓

• FORCE_IPV4 — Only use IPv4. no v6 allowed, we're keeping it old school.
• FORCE_IPV6 — Only use IPv6. v4 who? never heard of her.
• FTP_PASSIVE_MODE — If set to anything else than no passive mode will be set for the ftp connection. yes, "anything else than no" — that's the actual rule, read it twice bestie. 🫶
• FTP_LOGIN — User name to be set for ftp authentication.
• FTP_PASSWORD — Password to be set for ftp authentication.
• FTP_PROXY — Proxy URL that will be used to establish a ftp connection.
• HTTP_PROXY — Proxy URL that will be used to establish a http connection.
• HTTP_PROXY_AUTH — Sets the credentials to authenticate a user agent to a proxy server, in the form user:pass.
• HTTP_AUTH — Sets the credentials to authenticate to a http server, in the form user:pass.
• HTTP_REFERER — Overrides the default Referer http header. yes she's watching where you came from 👀
• HTTP_USER_AGENT — Override the default User-Agent http header.
• NO_PROXY — Specifies a set of domains for which the proxy should not be consulted. The contents is a comma-, or space-separated list of domain names. A single asterisk will override all proxy variables and no transactions will be proxied. that asterisk is the "leave me ALONE" button basically. 💀
• SOCKS_PROXY — Proxy URL that will be used to establish a socks connection.
• SSL_NO_VERIFY_HOSTNAME — Disables SSL/TLS hostname verification.
• SSL_NO_VERIFY_PEER — Disables SSL/TLS peer verification.
• SSL_CA_CERT_FILE — Overrides the default CA certificates file, by default set to /etc/ssl/certs/ca-certificates.crt.
• SSL_CA_CERT_PATH — Overrides the default CA certificates path, by default set to /etc/ssl/certs.
• SSL_CLIENT_CERT_FILE — Sets the SSL/TLS client verification certificate file.
• SSL_CLIENT_KEY_FILE — Sets the SSL/TLS client verification key file.
• CONNECTION_TIMEOUT — Sets connection timeout in milliseconds instead of default value of 5 minutes. When -1, waits indefinitely. she will wait for you forever, and I mean that literally. 😭

okay genuine note here: those SSL_NO_VERIFY_* ones turn off certificate checking, and turning off verification is a real security tradeoff — that's exactly what the names say, so don't @ me when you do it. 🙈

---

💀 EXIT STATUS 💀

A descriptive error message will be printed to stderr. that's the whole section. it's short, it's iconic, it's doing its best. ✨

---

🔥 SEE ALSO 🔥

the whole xbps friend group, honestly, it's giving family reunion:

xbps-alternatives(1), xbps-checkvers(1), xbps-create(1), xbps-dgraph(1), xbps-digest(1), xbps-fbulk(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 icon, the legend, the moment. 🫶

---

🙈 BUGS 🙈

Probably, but I try to make this not happen. Use it under your own responsibility and enjoy your life. and honestly? that's the most real thing in this whole page. live ur truth. 🌸

Report bugs at https://github.com/void-linux/xbps/issues — please do, they're literally asking, it's not weird, it's mutual aid. 💖

---

that's the whole vibe check, bestie 💅✨ — this gem came from the Debian side of things, dated Feb 9, 2023, and it lives comfortably at XBPS-FETCH(1). go forth and fetch. 🎀