ippproxy(8)

📦
version 0.0.0~git20220215.f365352 · 2 versions
, in debian bookworm, ubuntu resolute, ubuntu stonking

💅 ippproxy — the manual, but make it make sense

ok so bestie, you're looking at ippproxy(8), and yes that (8) means it's a system administration command — very grown-up of it. This page lives in the Apple Inc. section of your man pages and honestly? It's kinda iconic. Let's get into it 🫶

✨ NAME ✨

ippproxy — a simple ipp proxy client. that's it. that's the whole name section. short king behavior 💅

🌸 SYNOPSIS 🌸

ippproxy [ --help ] [ --version ] [ -d device-uri ] [ -m mime/type ] [
-p password ] [ -u user ] [ -v[vv] ] infrastructure-printer-uri

like, you pass it an infrastructure printer URI, and optionally a bunch of flags first. easy. no cap ✨

🦋 DESCRIPTION 🦋

ippproxy is a simple IPP proxy client, and it conforms to the IPP Shared Infrastructure Extensions (INFRA) specification — yes that's the whole flex. 🔥

What it does: it lets you proxy access to a local IPP printer through an Infrastructure Printer (think ippserver(8)). so your local printer gets to be a main character on the big stage. the way that works is genuinely so satisfying fr fr 💖

🎀 OPTIONS 🎀

here are the options ippproxy recognizes — read them, love them, use them correctly:

  • --help — show program help. your "what does this do again" button 🙈
  • --version — show program version. for when you need to know exactly which era of software you're in ⭐
  • -d device-uri — specifies the local device using its URI. ippproxy supports "ipp", "ipps", and "socket" URIs. three whole flavors, we love options 💅
  • -m mime/types — specifies the output format as a MIME media type. ippproxy supports "application/vnd.hp-pcl" (HP PCL), "image/pwg-raster" (PWG Raster), and "image/urf" (Apple Raster). the default is to choose an output format automatically — so if you're indecisive, just let it cook 🍓
  • -p password — specifies the password to use when authenticating with the Infrastructure Printer. keep it secret, keep it safe 🤫
  • -u user — specifies the user name to use when authenticating with the Infrastructure Printer. your whole identity, in one flag 👑
  • -v[vvv] — be (very) verbose when logging activity to the standard output. one v is a little chatty, more vs is full-on yapping about everything. literally what we're here for 💀

🌈 EXIT STATUS 🌈

ok so the drama: the ippproxy program returns 1 if it's unable to process the command-line arguments, or if it can't connect to either the infrastructure printer or the local printer. 😭

Otherwise? ippproxy will run continuously until terminated. and I mean continuously — it does not clock out. it does not take a lunch break. it just vibes there serving printer traffic until you say stop. periodt. 🔥

💜 CONFORMING TO 💜

the ippproxy program conforms to PWG Candidate Standard 5100.18: IPP Shared Infrastructure Extensions (INFRA). it said "let me follow the spec" and then it DID. ate and left no crumbs ✨

🧚 EXAMPLE 🧚

Run ippproxy with an infrastructure URI of "ipps://host.example.com/ipp/print" and a local URI of "ipp://10.0.1.42/ipp/print":

ippproxy -d ipp://10.0.1.42/ipp/print ipps://host.example.com/ipp/print

literally copy, paste, slay. the -d grabs the local device URI and the bare argument at the end is the infrastructure printer URI — that's the whole recipe, iykyk 🫶

⭐ SEE ALSO ⭐

go read these next, bestie, they're part of the lore:

Copyright © 2014-2018 by the IEEE-ISTO Printer Working Group. Copyright © 2007-2018 by Apple Inc.

okay that's the whole page — every flag, every URI, every supported media type, all of it 💖

and before you close this tab: this lil beauty comes from ippsample, dated 15 March 2018 — two things worth remembering the next time you're knee-deep in IPP and need a proxy. mwah 💋 bye bestie!! 🦋🌸

📦 where this page comes from