GEM
remote: https://rubygems.org/
specs:
- activesupport (4.2.10)
- i18n (~> 0.7)
- minitest (~> 5.1)
- thread_safe (~> 0.3, >= 0.3.4)
- tzinfo (~> 1.1)
- addressable (2.5.2)
- public_suffix (>= 2.0.2, < 4.0)
+ activesupport (8.0.2)
+ base64
+ benchmark (>= 0.3)
+ bigdecimal
+ concurrent-ruby (~> 1.0, >= 1.3.1)
+ connection_pool (>= 2.2.5)
+ drb
+ i18n (>= 1.6, < 2)
+ logger (>= 1.4.2)
+ minitest (>= 5.1)
+ securerandom (>= 0.3)
+ tzinfo (~> 2.0, >= 2.0.5)
+ uri (>= 0.13.1)
+ addressable (2.8.7)
+ public_suffix (>= 2.0.2, < 7.0)
+ base64 (0.2.0)
+ benchmark (0.4.0)
+ bigdecimal (3.1.9)
coffee-script (2.4.1)
coffee-script-source
execjs
- coffee-script-source (1.11.1)
+ coffee-script-source (1.12.2)
colorator (1.1.0)
- commonmarker (0.17.13)
- ruby-enum (~> 0.5)
- concurrent-ruby (1.1.3)
- dnsruby (1.61.2)
- addressable (~> 2.5)
- em-websocket (0.5.1)
+ commonmarker (0.23.11)
+ concurrent-ruby (1.3.5)
+ connection_pool (2.5.0)
+ csv (3.3.3)
+ dnsruby (1.72.4)
+ base64 (~> 0.2.0)
+ logger (~> 1.6.5)
+ simpleidn (~> 0.2.1)
+ drb (2.2.1)
+ em-websocket (0.5.3)
eventmachine (>= 0.12.9)
- http_parser.rb (~> 0.6.0)
- ethon (0.11.0)
- ffi (>= 1.3.0)
+ http_parser.rb (~> 0)
+ ethon (0.16.0)
+ ffi (>= 1.15.0)
eventmachine (1.2.7)
- execjs (2.7.0)
- faraday (0.15.4)
- multipart-post (>= 1.2, < 3)
- ffi (1.15.5)
+ execjs (2.10.0)
+ faraday (2.12.2)
+ faraday-net_http (>= 2.0, < 3.5)
+ json
+ logger
+ faraday-net_http (3.4.0)
+ net-http (>= 0.5.0)
+ ffi (1.17.1-aarch64-linux-gnu)
+ ffi (1.17.1-aarch64-linux-musl)
+ ffi (1.17.1-arm-linux-gnu)
+ ffi (1.17.1-arm-linux-musl)
+ ffi (1.17.1-arm64-darwin)
+ ffi (1.17.1-x86_64-darwin)
+ ffi (1.17.1-x86_64-linux-gnu)
+ ffi (1.17.1-x86_64-linux-musl)
forwardable-extended (2.6.0)
- gemoji (3.0.0)
- github-pages (193)
- activesupport (= 4.2.10)
- github-pages-health-check (= 1.8.1)
- jekyll (= 3.7.4)
- jekyll-avatar (= 0.6.0)
- jekyll-coffeescript (= 1.1.1)
- jekyll-commonmark-ghpages (= 0.1.5)
- jekyll-default-layout (= 0.1.4)
- jekyll-feed (= 0.11.0)
+ gemoji (4.1.0)
+ github-pages (232)
+ github-pages-health-check (= 1.18.2)
+ jekyll (= 3.10.0)
+ jekyll-avatar (= 0.8.0)
+ jekyll-coffeescript (= 1.2.2)
+ jekyll-commonmark-ghpages (= 0.5.1)
+ jekyll-default-layout (= 0.1.5)
+ jekyll-feed (= 0.17.0)
jekyll-gist (= 1.5.0)
- jekyll-github-metadata (= 2.9.4)
- jekyll-mentions (= 1.4.1)
- jekyll-optional-front-matter (= 0.3.0)
+ jekyll-github-metadata (= 2.16.1)
+ jekyll-include-cache (= 0.2.1)
+ jekyll-mentions (= 1.6.0)
+ jekyll-optional-front-matter (= 0.3.2)
jekyll-paginate (= 1.1.0)
- jekyll-readme-index (= 0.2.0)
- jekyll-redirect-from (= 0.14.0)
- jekyll-relative-links (= 0.5.3)
- jekyll-remote-theme (= 0.3.1)
+ jekyll-readme-index (= 0.3.0)
+ jekyll-redirect-from (= 0.16.0)
+ jekyll-relative-links (= 0.6.1)
+ jekyll-remote-theme (= 0.4.3)
jekyll-sass-converter (= 1.5.2)
- jekyll-seo-tag (= 2.5.0)
- jekyll-sitemap (= 1.2.0)
- jekyll-swiss (= 0.4.0)
- jekyll-theme-architect (= 0.1.1)
- jekyll-theme-cayman (= 0.1.1)
- jekyll-theme-dinky (= 0.1.1)
- jekyll-theme-hacker (= 0.1.1)
- jekyll-theme-leap-day (= 0.1.1)
- jekyll-theme-merlot (= 0.1.1)
- jekyll-theme-midnight (= 0.1.1)
- jekyll-theme-minimal (= 0.1.1)
- jekyll-theme-modernist (= 0.1.1)
- jekyll-theme-primer (= 0.5.3)
- jekyll-theme-slate (= 0.1.1)
- jekyll-theme-tactile (= 0.1.1)
- jekyll-theme-time-machine (= 0.1.1)
- jekyll-titles-from-headings (= 0.5.1)
- jemoji (= 0.10.1)
- kramdown (= 1.17.0)
- liquid (= 4.0.0)
- listen (= 3.1.5)
+ jekyll-seo-tag (= 2.8.0)
+ jekyll-sitemap (= 1.4.0)
+ jekyll-swiss (= 1.0.0)
+ jekyll-theme-architect (= 0.2.0)
+ jekyll-theme-cayman (= 0.2.0)
+ jekyll-theme-dinky (= 0.2.0)
+ jekyll-theme-hacker (= 0.2.0)
+ jekyll-theme-leap-day (= 0.2.0)
+ jekyll-theme-merlot (= 0.2.0)
+ jekyll-theme-midnight (= 0.2.0)
+ jekyll-theme-minimal (= 0.2.0)
+ jekyll-theme-modernist (= 0.2.0)
+ jekyll-theme-primer (= 0.6.0)
+ jekyll-theme-slate (= 0.2.0)
+ jekyll-theme-tactile (= 0.2.0)
+ jekyll-theme-time-machine (= 0.2.0)
+ jekyll-titles-from-headings (= 0.5.3)
+ jemoji (= 0.13.0)
+ kramdown (= 2.4.0)
+ kramdown-parser-gfm (= 1.1.0)
+ liquid (= 4.0.4)
mercenary (~> 0.3)
- minima (= 2.5.0)
- nokogiri (>= 1.8.2, < 2.0)
- rouge (= 2.2.1)
+ minima (= 2.5.1)
+ nokogiri (>= 1.16.2, < 2.0)
+ rouge (= 3.30.0)
terminal-table (~> 1.4)
- github-pages-health-check (1.8.1)
+ webrick (~> 1.8)
+ github-pages-health-check (1.18.2)
addressable (~> 2.3)
dnsruby (~> 1.60)
- octokit (~> 4.0)
- public_suffix (~> 2.0)
+ octokit (>= 4, < 8)
+ public_suffix (>= 3.0, < 6.0)
typhoeus (~> 1.3)
- html-pipeline (2.9.1)
+ html-pipeline (2.14.3)
activesupport (>= 2)
nokogiri (>= 1.4)
- http_parser.rb (0.6.0)
- i18n (0.9.5)
+ http_parser.rb (0.8.0)
+ i18n (1.14.7)
concurrent-ruby (~> 1.0)
- jekyll (3.7.4)
+ jekyll (3.10.0)
addressable (~> 2.4)
colorator (~> 1.0)
+ csv (~> 3.0)
em-websocket (~> 0.5)
- i18n (~> 0.7)
+ i18n (>= 0.7, < 2)
jekyll-sass-converter (~> 1.0)
jekyll-watch (~> 2.0)
- kramdown (~> 1.14)
+ kramdown (>= 1.17, < 3)
liquid (~> 4.0)
mercenary (~> 0.3.3)
pathutil (~> 0.9)
rouge (>= 1.7, < 4)
safe_yaml (~> 1.0)
- jekyll-avatar (0.6.0)
- jekyll (~> 3.0)
- jekyll-coffeescript (1.1.1)
+ webrick (>= 1.0)
+ jekyll-avatar (0.8.0)
+ jekyll (>= 3.0, < 5.0)
+ jekyll-coffeescript (1.2.2)
coffee-script (~> 2.2)
- coffee-script-source (~> 1.11.1)
- jekyll-commonmark (1.2.0)
- commonmarker (~> 0.14)
- jekyll (>= 3.0, < 4.0)
- jekyll-commonmark-ghpages (0.1.5)
- commonmarker (~> 0.17.6)
- jekyll-commonmark (~> 1)
- rouge (~> 2)
- jekyll-default-layout (0.1.4)
- jekyll (~> 3.0)
- jekyll-feed (0.11.0)
- jekyll (~> 3.3)
+ coffee-script-source (~> 1.12)
+ jekyll-commonmark (1.4.0)
+ commonmarker (~> 0.22)
+ jekyll-commonmark-ghpages (0.5.1)
+ commonmarker (>= 0.23.7, < 1.1.0)
+ jekyll (>= 3.9, < 4.0)
+ jekyll-commonmark (~> 1.4.0)
+ rouge (>= 2.0, < 5.0)
+ jekyll-default-layout (0.1.5)
+ jekyll (>= 3.0, < 5.0)
+ jekyll-feed (0.17.0)
+ jekyll (>= 3.7, < 5.0)
jekyll-gist (1.5.0)
octokit (~> 4.2)
- jekyll-github-metadata (2.9.4)
- jekyll (~> 3.1)
- octokit (~> 4.0, != 4.4.0)
- jekyll-mentions (1.4.1)
+ jekyll-github-metadata (2.16.1)
+ jekyll (>= 3.4, < 5.0)
+ octokit (>= 4, < 7, != 4.4.0)
+ jekyll-include-cache (0.2.1)
+ jekyll (>= 3.7, < 5.0)
+ jekyll-mentions (1.6.0)
html-pipeline (~> 2.3)
- jekyll (~> 3.0)
- jekyll-optional-front-matter (0.3.0)
- jekyll (~> 3.0)
+ jekyll (>= 3.7, < 5.0)
+ jekyll-optional-front-matter (0.3.2)
+ jekyll (>= 3.0, < 5.0)
jekyll-paginate (1.1.0)
- jekyll-readme-index (0.2.0)
- jekyll (~> 3.0)
- jekyll-redirect-from (0.14.0)
- jekyll (~> 3.3)
- jekyll-relative-links (0.5.3)
- jekyll (~> 3.3)
- jekyll-remote-theme (0.3.1)
- jekyll (~> 3.5)
- rubyzip (>= 1.2.1, < 3.0)
+ jekyll-readme-index (0.3.0)
+ jekyll (>= 3.0, < 5.0)
+ jekyll-redirect-from (0.16.0)
+ jekyll (>= 3.3, < 5.0)
+ jekyll-relative-links (0.6.1)
+ jekyll (>= 3.3, < 5.0)
+ jekyll-remote-theme (0.4.3)
+ addressable (~> 2.0)
+ jekyll (>= 3.5, < 5.0)
+ jekyll-sass-converter (>= 1.0, <= 3.0.0, != 2.0.0)
+ rubyzip (>= 1.3.0, < 3.0)
jekyll-sass-converter (1.5.2)
sass (~> 3.4)
- jekyll-seo-tag (2.5.0)
- jekyll (~> 3.3)
- jekyll-sitemap (1.2.0)
- jekyll (~> 3.3)
- jekyll-swiss (0.4.0)
- jekyll-theme-architect (0.1.1)
- jekyll (~> 3.5)
+ jekyll-seo-tag (2.8.0)
+ jekyll (>= 3.8, < 5.0)
+ jekyll-sitemap (1.4.0)
+ jekyll (>= 3.7, < 5.0)
+ jekyll-swiss (1.0.0)
+ jekyll-theme-architect (0.2.0)
+ jekyll (> 3.5, < 5.0)
jekyll-seo-tag (~> 2.0)
- jekyll-theme-cayman (0.1.1)
- jekyll (~> 3.5)
+ jekyll-theme-cayman (0.2.0)
+ jekyll (> 3.5, < 5.0)
jekyll-seo-tag (~> 2.0)
- jekyll-theme-dinky (0.1.1)
- jekyll (~> 3.5)
+ jekyll-theme-dinky (0.2.0)
+ jekyll (> 3.5, < 5.0)
jekyll-seo-tag (~> 2.0)
- jekyll-theme-hacker (0.1.1)
- jekyll (~> 3.5)
+ jekyll-theme-hacker (0.2.0)
+ jekyll (> 3.5, < 5.0)
jekyll-seo-tag (~> 2.0)
- jekyll-theme-leap-day (0.1.1)
- jekyll (~> 3.5)
+ jekyll-theme-leap-day (0.2.0)
+ jekyll (> 3.5, < 5.0)
jekyll-seo-tag (~> 2.0)
- jekyll-theme-merlot (0.1.1)
- jekyll (~> 3.5)
+ jekyll-theme-merlot (0.2.0)
+ jekyll (> 3.5, < 5.0)
jekyll-seo-tag (~> 2.0)
- jekyll-theme-midnight (0.1.1)
- jekyll (~> 3.5)
+ jekyll-theme-midnight (0.2.0)
+ jekyll (> 3.5, < 5.0)
jekyll-seo-tag (~> 2.0)
- jekyll-theme-minimal (0.1.1)
- jekyll (~> 3.5)
+ jekyll-theme-minimal (0.2.0)
+ jekyll (> 3.5, < 5.0)
jekyll-seo-tag (~> 2.0)
- jekyll-theme-modernist (0.1.1)
- jekyll (~> 3.5)
+ jekyll-theme-modernist (0.2.0)
+ jekyll (> 3.5, < 5.0)
jekyll-seo-tag (~> 2.0)
- jekyll-theme-primer (0.5.3)
- jekyll (~> 3.5)
+ jekyll-theme-primer (0.6.0)
+ jekyll (> 3.5, < 5.0)
jekyll-github-metadata (~> 2.9)
jekyll-seo-tag (~> 2.0)
- jekyll-theme-slate (0.1.1)
- jekyll (~> 3.5)
+ jekyll-theme-slate (0.2.0)
+ jekyll (> 3.5, < 5.0)
jekyll-seo-tag (~> 2.0)
- jekyll-theme-tactile (0.1.1)
- jekyll (~> 3.5)
+ jekyll-theme-tactile (0.2.0)
+ jekyll (> 3.5, < 5.0)
jekyll-seo-tag (~> 2.0)
- jekyll-theme-time-machine (0.1.1)
- jekyll (~> 3.5)
+ jekyll-theme-time-machine (0.2.0)
+ jekyll (> 3.5, < 5.0)
jekyll-seo-tag (~> 2.0)
- jekyll-titles-from-headings (0.5.1)
- jekyll (~> 3.3)
- jekyll-watch (2.1.2)
+ jekyll-titles-from-headings (0.5.3)
+ jekyll (>= 3.3, < 5.0)
+ jekyll-watch (2.2.1)
listen (~> 3.0)
- jemoji (0.10.1)
- gemoji (~> 3.0)
+ jemoji (0.13.0)
+ gemoji (>= 3, < 5)
html-pipeline (~> 2.2)
- jekyll (~> 3.0)
- kramdown (1.17.0)
- liquid (4.0.0)
- listen (3.1.5)
- rb-fsevent (~> 0.9, >= 0.9.4)
- rb-inotify (~> 0.9, >= 0.9.7)
- ruby_dep (~> 1.2)
+ jekyll (>= 3.0, < 5.0)
+ json (2.10.2)
+ kramdown (2.4.0)
+ rexml
+ kramdown-parser-gfm (1.1.0)
+ kramdown (~> 2.0)
+ liquid (4.0.4)
+ listen (3.9.0)
+ rb-fsevent (~> 0.10, >= 0.10.3)
+ rb-inotify (~> 0.9, >= 0.9.10)
+ logger (1.6.6)
mercenary (0.3.6)
- mini_portile2 (2.3.0)
- minima (2.5.0)
- jekyll (~> 3.5)
+ minima (2.5.1)
+ jekyll (>= 3.5, < 5.0)
jekyll-feed (~> 0.9)
jekyll-seo-tag (~> 2.1)
- minitest (5.11.3)
- multipart-post (2.0.0)
- nokogiri (1.8.5)
- mini_portile2 (~> 2.3.0)
- octokit (4.13.0)
- sawyer (~> 0.8.0, >= 0.5.3)
+ minitest (5.25.5)
+ net-http (0.6.0)
+ uri
+ nokogiri (1.18.6-aarch64-linux-gnu)
+ racc (~> 1.4)
+ nokogiri (1.18.6-aarch64-linux-musl)
+ racc (~> 1.4)
+ nokogiri (1.18.6-arm-linux-gnu)
+ racc (~> 1.4)
+ nokogiri (1.18.6-arm-linux-musl)
+ racc (~> 1.4)
+ nokogiri (1.18.6-arm64-darwin)
+ racc (~> 1.4)
+ nokogiri (1.18.6-x86_64-darwin)
+ racc (~> 1.4)
+ nokogiri (1.18.6-x86_64-linux-gnu)
+ racc (~> 1.4)
+ nokogiri (1.18.6-x86_64-linux-musl)
+ racc (~> 1.4)
+ octokit (4.25.1)
+ faraday (>= 1, < 3)
+ sawyer (~> 0.9)
pathutil (0.16.2)
forwardable-extended (~> 2.6)
- public_suffix (2.0.5)
- rb-fsevent (0.10.3)
- rb-inotify (0.9.10)
- ffi (>= 0.5.0, < 2)
- rouge (2.2.1)
- ruby-enum (0.7.2)
- i18n
- ruby_dep (1.5.0)
- rubyzip (1.2.2)
- safe_yaml (1.0.4)
- sass (3.7.2)
+ public_suffix (5.1.1)
+ racc (1.8.1)
+ rb-fsevent (0.11.2)
+ rb-inotify (0.11.1)
+ ffi (~> 1.0)
+ rexml (3.4.1)
+ rouge (3.30.0)
+ rubyzip (2.4.1)
+ safe_yaml (1.0.5)
+ sass (3.7.4)
sass-listen (~> 4.0.0)
sass-listen (4.0.0)
rb-fsevent (~> 0.9, >= 0.9.4)
rb-inotify (~> 0.9, >= 0.9.7)
- sawyer (0.8.1)
- addressable (>= 2.3.5, < 2.6)
- faraday (~> 0.8, < 1.0)
+ sawyer (0.9.2)
+ addressable (>= 2.3.5)
+ faraday (>= 0.17.3, < 3)
+ securerandom (0.4.1)
+ simpleidn (0.2.3)
terminal-table (1.8.0)
unicode-display_width (~> 1.1, >= 1.1.1)
- thread_safe (0.3.6)
- typhoeus (1.3.1)
+ typhoeus (1.4.1)
ethon (>= 0.9.0)
- tzinfo (1.2.5)
- thread_safe (~> 0.1)
- unicode-display_width (1.4.0)
+ tzinfo (2.0.6)
+ concurrent-ruby (~> 1.0)
+ unicode-display_width (1.8.0)
+ uri (1.0.3)
+ webrick (1.9.1)
PLATFORMS
- ruby
+ aarch64-linux-gnu
+ aarch64-linux-musl
+ arm-linux-gnu
+ arm-linux-musl
+ arm64-darwin
+ x86_64-darwin
+ x86_64-linux-gnu
+ x86_64-linux-musl
DEPENDENCIES
github-pages
BUNDLED WITH
- 1.17.2
+ 2.6.6
<h2>Man Pages</h2>
<ul>
<li>cancel(1) - cancel jobs: <a href="cancel.html">HTML</a></li>
- <li>client.conf(5) - client configuration file for cups: <a href="client.conf.html">HTML</a></li>
<li>cups(1) - a standards-based, open source printing system: <a href="cups.html">HTML</a></li>
<li>cupsaccept/cupsreject(8) - accept/reject jobs sent to a destination: <a href="cupsaccept/cupsreject.html">HTML</a></li>
<li>cupsdisable, cupsenable(8) - stop/start printers and classes: <a href="cupsdisable, cupsenable.html">HTML</a></li>
·
<a href="#DOCUMENTATION">Documentation</a>
</span>
- <a class="btn btn-primary btn-large" href="https://github.com/OpenPrinting/libcups/releases"><i class="bi bi-download"></i> libcups</a>
- <a class="btn btn-secondary btn-large" href="https://github.com/OpenPrinting/cups-local/releases"><i class="bi bi-download"></i> cups-local</a>
- <a class="btn btn-secondary btn-large" href="https://github.com/OpenPrinting/cups-sharing/releases"><i class="bi bi-download"></i> cups-sharing</a>
+ <a class="btn btn-primary btn-large" href="https://github.com/OpenPrinting/libcups/releases"><i class="bi bi-download"></i> libcups<img src="https://img.shields.io/github/v/release/OpenPrinting/libcups?style=for-the-badge&label=%20&labelColor=%2377777700&color=%2377777700"></a>
+ <a class="btn btn-secondary btn-large" href="https://github.com/OpenPrinting/cups-local/releases"><i class="bi bi-download"></i> cups-local<!--<img src="https://img.shields.io/github/v/release/OpenPrinting/cups-local?style=for-the-badge&label=%20&labelColor=%2377777700&color=%2377777700">--></a>
+ <a class="btn btn-secondary btn-large" href="https://github.com/OpenPrinting/cups-sharing/releases"><i class="bi bi-download"></i> cups-sharing<!--<img src="https://img.shields.io/github/v/release/OpenPrinting/cups-sharing?style=for-the-badge&label=%20&labelColor=%2377777700&color=%2377777700">--></a>
</p>
</div>
<div class="col col-md-3">
<div class="col col-md-12">
<ul>
<li>cancel(1) - cancel jobs: <a href="cups-local/cancel.html">HTML</a></li>
- <li>client.conf(5) - client configuration file for cups: <a href="cups-local/client.conf.html">HTML</a></li>
+ <li>client.conf(5) - client configuration file for cups: <a href="libcups/client.conf.html">HTML</a></li>
<li>cups(1) - a standards-based, open source printing system: <a href="cups-local/cups.html">HTML</a></li>
<li>cupsaccept/cupsreject(8) - accept/reject jobs sent to a destination: <a href="cups-local/cupsaccept/cupsreject.html">HTML</a></li>
<li>cupsdisable, cupsenable(8) - stop/start printers and classes: <a href="cups-local/cupsdisable, cupsenable.html">HTML</a></li>
+ <li>cups-oauth(1) - Interact with an OAuth/OpenID Authorization Server: <a href="libcups/cups-oauth.html">HTML</a></li>
+ <li>cups-x509(1) - Manage X.509 Certificates and Certificate Requests: <a href="libcups/cups-x509.html">HTML</a></li>
<li>ippeveprinter(1) - An IPP Everywhere Printer Application for CUPS: <a href="libcups/ippeveprinter.html">HTML</a></li>
<li>ippfind(1) - Find Internet Printing Protocol Printers: <a href="libcups/ippfind.html">HTML</a></li>
<li>ipptool(1) - Perform Internet Printing Protocol Requests: <a href="libcups/ipptool.html">HTML</a></li>
<li>CUPS Implementation of IPP: <a href="libcups/spec-ipp.html">HTML</a></li>
<li>CUPS Programming Manual: <a href="libcups/cupspm.html">HTML</a> · <a href="libcups/cupspm.epub">EPUB</a></li>
<li>CUPS Raster Format: <a href="libcups/spec-raster.html">HTML</a></li>
+ <li>libcups(3) - CUPS API Library: <a href="libcups/libcups.html">HTML</a></li>
</ul>
</div>
</div>
.center {
text-align: center;
}
+a:link, a:visited {
+ color: #c00;
+ text-decoration: underline;
+}
+
+a:link:hover, a:active {
+ color: #f00;
+ text-decoration: underline;
+}
code, kbd, pre, tt {
font-family: monospace;
}
text-align: justify;
}
span.info {
- background: rgba(127,127,127,0.5);
- border-radius: 5px;
+ background: #ddf;
+ border: solid 1px #77c;
+ border-top-left-radius: 5px;
+ border-top-right-radius: 5px;
float: right;
font-size: 80%;
- padding: 4px 10px;
+ padding: 2px 10px;
}
h4 span.info {
- padding: 2px 8px;
+ padding: 1px 8px;
}
table {
border-collapse: collapse;
margin-right: auto;
max-width: 90%;
}
-table caption {
- font-style: italic;
- margin-bottom: 1em;
-}
table thead th {
border-bottom: solid 2px black;
padding: 0 10px;
vertical-align: bottom;
}
table tbody tr:nth-child(even) {
- background: rgba(127,127,127,0.125);
+ background: #ddd;
}
table tbody td {
border-bottom: solid 1px black;
padding: 4px 10px;
vertical-align: top;
}
-table.figure tbody td {
- border-bottom: none;
+blockquote {
+ background: #ddf;
+ border-left: solid 2px #77c;
+ margin-left: 0;
+ margin-right: 0;
+ padding: 10px;
+}
+/* Dark mode overrides */
+@media (prefers-color-scheme: dark) {
+ body {
+ background: black;
+ color: #ccc;
+ }
+ h2, h3, h4, table tbody td, table thead th {
+ border-color: #ccc;
+ }
+ blockquote, span.info {
+ background: #337;
+ border-color: #66f;
+ }
+ table tbody tr:nth-child(even) {
+ background: #444;
+ }
}
--></style>
- <meta name="creator" content="mantohtml v2.0.1">
+ <meta name="creator" content="mantohtml v2.0.2">
<title>client.conf(5)</title>
</head>
<body>
<p>The <strong>client.conf</strong> file configures the CUPS client and is normally located in the <em>/etc/cups</em> and/or <em>~/.cups</em> directories.
Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
</p>
- <p><strong>Note:</strong> Starting with macOS 10.7, this file is only used by command-line and X11 applications plus the IPP backend.
-The <strong>ServerName</strong> directive is not supported on macOS at all.
-Starting with macOS 10.12, all applications can access these settings in the <em>/Library/Preferences/org.cups.PrintingPrefs.plist</em> file instead.
+ <p><strong>Note:</strong> macOS applications can access many of these settings in the <em>/Library/Preferences/org.cups.PrintingPrefs.plist</em> file instead.
+macOS also does not support the
+<strong>ServerName</strong>
+directive.
See the NOTES section below for more information.
</p>
<h3 id="client.conf-5.description.directives">Directives</h3>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>Encryption Required</strong><br>
Specifies the level of encryption that should be used.
</p>
- <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>GSSServiceName </strong><em>name</em><br>
-Specifies the Kerberos service name that is used for authentication, typically "host", "http", or "ipp".
-CUPS adds the remote hostname ("name@server.example.com") for you. The default name is "http".
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>BrowseDomains all</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>BrowseDomains none</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>BrowseDomains </strong><em>DOMAIN[,...,DOMAIN]</em><br>
+Specifies the DNS-SD domains to browse for IPP printers.
+The value "all" browses the ".local" domain (mDNS) and all registered DNS domains on the local system.
+The value "none" disables browsing for network printers.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FilterLocation </strong><em>LOCATION[,...,LOCATION]</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FilterLocation </strong><em>'LOCATION'[,...,'LOCATION']</em><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FilterLocation </strong><em>"LOCATION"[,...,"LOCATION"]</em><br>
+Specifies a list of locations to use for destinations.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FilterLocation </strong><em>/REGULAR-EXPRESSION/</em><br>
+Specifies a regular expression for matching locations to use for destinations.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FilterType any</strong><br>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>FilterType </strong><em>TYPE[,...,TYPE]</em><br>
+Specifies the type of destinations to use.
+The TYPE values are "mono" for B&W printers, "color" for color printers, "duplex" for printers with 2-sided printing capabilities, "simplex" for printers with 1-sided printing capabilities, "bind" for printers that can bind output, "cover" for printers that can cover output, "punch" for printers that can punch output, "sort" for printers that can sort output, "staple" for printers with a stapler, "small" for printers that support media up to US Legal/ISO A4, "medium" for printers that support media up to US Tabloid/ISO A3, and "large" for printers that support media larger than US Tabloid/ISO A3.
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ServerName </strong><em>hostname-or-ip-address</em>[<em>:port</em>]<br>
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ValidateCerts Yes</strong><br>
</p>
<p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>ValidateCerts No</strong><br>
-Specifies whether to only allow TLS with certificates whose common name matches the hostname.
+Specifies whether to only allow TLS with certificates whose commonName or subjectAltName values match the hostname of the printer or server.
The default is "No".
+</p>
+ <h2 id="client.conf-5.x.509-certificate-store">X.509 Certificate Store</h2>
+<p>CUPS uses the system root CA certificate store and per-user certificate stores managed by CUPS.
+The per-user certificate stores are found in "/etc/cups/ssl" for the root user and "$XDG_CONFIG_HOME/cups/ssl" (Linux/*BSD), "$HOME/Library/Application Support/cups/ssl" (macOS), "%USERPROFILE%/AppData/Local/cups" (Windows), and/or "$HOME/.cups/ssl" for other user accounts.
+</p>
+ <p>Certificates, certificate signing requests, and private keys are stored as PEM-encoded files with the naming convention "COMMON-NAME.crt" for certificates, "COMMON-NAME.csr" for certificate signing requests, and "COMMON-NAME.key" for private keys. The special common name "_site_" is used for a site-specific root certificate that can be used for trust evaluations.
+</p>
+ <h2 id="client.conf-5.x.509-certificate-validation">X.509 Certificate Validation</h2>
+<p>CUPS supports validation of the certificate's commonName and subjectAltName field values, the certificate expiration date, and the certificate's root certificate(s), if any.
+Self-signed certificates are "pinned" (stored) to the host in order to do validation.
+Validation for certain non-printing servers may add additional restrictions to the policy defined in the
+<strong>client.conf</strong>
+file, for example OAuth authorization requires a CA-signed certificate.
+</p>
+ <p>The
+<strong>AllowAnyRoot</strong>
+directive controls whether unpinned self-signed certificates are acceptable.
+The
+<strong>TrustOnFirstUse</strong>
+directive controls whether self-certificates are automatically pinned in the per-user certificate store for subsequent host validations.
+When
+<strong>AllowAnyRoot</strong>
+is disabled,
+<strong>TrustOnFirstUse</strong>
+is also disabled.
</p>
<h2 id="client.conf-5.notes">Notes</h2>
-<p>The <strong>client.conf</strong> file is deprecated on macOS and will no longer be supported in a future version of CUPS.
+<p>Because of sandboxing, the <strong>client.conf</strong> file is not generally accessible to applications on macOS.
Configuration settings can instead be viewed or changed using the
<strong>defaults</strong>(1)
<h2 id="client.conf-5.see-also">See Also</h2>
<p><strong>cups</strong>(1),
-<strong>default</strong>(1),
+<a href="cups-x509.html"><strong>cups-x509</strong>(1)</a>
-CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
<h2 id="client.conf-5.copyright">Copyright</h2>
-<p>Copyright © 2021-2023 by OpenPrinting.
+<p>Copyright © 2021-2025 by OpenPrinting.
</body>
</html>
--- /dev/null
+<!DOCTYPE html>
+<html>
+ <head>
+ <style><!--
+body {
+ font-family: sans-serif;
+ font-size: 16pt;
+ margin: 54pt 36pt;
+}
+.center {
+ text-align: center;
+}
+a:link, a:visited {
+ color: #c00;
+ text-decoration: underline;
+}
+
+a:link:hover, a:active {
+ color: #f00;
+ text-decoration: underline;
+}
+code, kbd, pre, tt {
+ font-family: monospace;
+}
+dl {
+ margin-left: 2em;
+}
+h2, h3 {
+ border-bottom: solid 2px black;
+}
+h4 {
+ border-bottom: solid 1px black;
+}
+p {
+ text-align: justify;
+}
+span.info {
+ background: #ddf;
+ border: solid 1px #77c;
+ border-top-left-radius: 5px;
+ border-top-right-radius: 5px;
+ float: right;
+ font-size: 80%;
+ padding: 2px 10px;
+}
+h4 span.info {
+ padding: 1px 8px;
+}
+table {
+ border-collapse: collapse;
+ margin-left: auto;
+ margin-right: auto;
+ max-width: 90%;
+}
+table thead th {
+ border-bottom: solid 2px black;
+ padding: 0 10px;
+ text-align: left;
+ vertical-align: bottom;
+}
+table tbody tr:nth-child(even) {
+ background: #ddd;
+}
+table tbody td {
+ border-bottom: solid 1px black;
+ padding: 4px 10px;
+ vertical-align: top;
+}
+blockquote {
+ background: #ddf;
+ border-left: solid 2px #77c;
+ margin-left: 0;
+ margin-right: 0;
+ padding: 10px;
+}
+/* Dark mode overrides */
+@media (prefers-color-scheme: dark) {
+ body {
+ background: black;
+ color: #ccc;
+ }
+ h2, h3, h4, table tbody td, table thead th {
+ border-color: #ccc;
+ }
+ blockquote, span.info {
+ background: #337;
+ border-color: #66f;
+ }
+ table tbody tr:nth-child(even) {
+ background: #444;
+ }
+}
+--></style>
+ <meta name="creator" content="mantohtml v2.0.2">
+ <title>cups-oauth(1)</title>
+ </head>
+ <body>
+ <h1 id="cups-oauth-1">cups-oauth(1)</h1>
+ <h2 id="cups-oauth-1.name">Name</h2>
+<p>cups-oauth - interact with an oauth/openid authorization server
+</p>
+ <h2 id="cups-oauth-1.synopsis">Synopsis</h2>
+<p><strong>cups-oauth</strong>
+<strong>--help</strong>
+<br>
+<strong>cups-oauth</strong>
+<strong>--version</strong>
+<br>
+<strong>cups-oauth</strong>
+[
+<strong>-a</strong>
+<em>OAUTH-URI</em>
+] [
+<strong>-s</strong>
+<em>SCOPE(S)</em>
+]
+<strong>authorize</strong>
+<em>[RESOURCE]</em>
+<br>
+<strong>cups-oauth</strong>
+[
+<strong>-a</strong>
+<em>OAUTH-URI</em>
+]
+<strong>clear</strong>
+<em>[RESOURCE]</em>
+<br>
+<strong>cups-oauth</strong>
+[
+<strong>-a</strong>
+<em>OAUTH-URI</em>
+]
+<strong>get-access-token</strong>
+<em>[RESOURCE]</em>
+<br>
+<strong>cups-oauth</strong>
+[
+<strong>-a</strong>
+<em>OAUTH-URI</em>
+]
+<strong>get-client-id</strong>
+<br>
+<strong>cups-oauth</strong>
+[
+<strong>-a</strong>
+<em>OAUTH-URI</em>
+]
+<strong>get-metadata</strong>
+<em>[NAME]</em>
+<br>
+<strong>cups-oauth</strong>
+[
+<strong>-a</strong>
+<em>OAUTH-URI</em>
+]
+<strong>get-user-id</strong>
+<em>[RESOURCE]</em>
+<em>[NAME]</em>
+<br>
+<strong>cups-oauth</strong>
+[
+<strong>-a</strong>
+<em>OAUTH-URI</em>
+]
+<strong>set-access-token</strong>
+<em>[RESOURCE]</em>
+<em>TOKEN</em>
+<br>
+<strong>cups-oauth</strong>
+[
+<strong>-a</strong>
+<em>OAUTH-URI</em>
+]
+<strong>set-client-data</strong>
+<em>CLIENT-ID</em>
+<em>CLIENT-SECRET</em>
+</p>
+ <h2 id="cups-oauth-1.description">Description</h2>
+<p>The
+<strong>cups-oauth</strong>
+utility interacts with an OAuth/OpenID authorization server.
+Authorizations are often linked to a resource (a printer URI, web page URL, etc.)
+</p>
+ <h2 id="cups-oauth-1.options">Options</h2>
+<p>The following options are recognized by
+<strong>cups-oauth:</strong>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--help</strong><br>
+Show program usage.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--version</strong><br>
+Show the CUPS version.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-a </strong><em>OAUTH-URI</em><br>
+Specifies the OAuth/OpenID authorization server URL.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-s </strong><em>SCOPE(S)</em><br>
+Specifies a space-delimited list of scope names to use when authorizing access.
+The default is to request authorization for all supported scopes.
+</p>
+ <h2 id="cups-oauth-1.commands">Commands</h2>
+ <h3 id="cups-oauth-1.commands.authorize">Authorize</h3>
+<p>Starts an authorization workflow with the default web browser.
+If a resource URI is specified, the authorization is specific to that resource.
+The access token is send to the standard output on success.
+</p>
+ <h3 id="cups-oauth-1.commands.clear">Clear</h3>
+<p>Clears any authorization for the specified resource or for all resources if no resource URI is supplied.
+</p>
+ <h3 id="cups-oauth-1.commands.get-access-token">Get-Access-Token</h3>
+<p>Output the current, unexpired access token, if any, to the standard output.
+</p>
+ <h3 id="cups-oauth-1.commands.get-client-id">Get-Client-Id</h3>
+<p>Output the client ID string, if any, to the standard output.
+</p>
+ <h3 id="cups-oauth-1.commands.get-metadata">Get-Metadata</h3>
+<p>Get the OAuth/OpenID authorization server metadata and send it to the standard output.
+If a name is specified, the output is just the value for the specified metadata.
+</p>
+ <h3 id="cups-oauth-1.commands.get-user-id">Get-User-Id</h3>
+<p>Get the OpenID user ID information and send it to the standard output.
+If a name is specified, the output is just the named claim from the user ID.
+</p>
+ <h3 id="cups-oauth-1.commands.set-access-token">Set-Access-Token</h3>
+<p>Set the access token (which is sometimes also called an API key) for the specified resource or for all resources.
+</p>
+ <h3 id="cups-oauth-1.commands.set-client-data">Set-Client-Data</h3>
+<p>Set the client ID string and secret for an OAuth/OpenID authorization server.
+</p>
+ <h2 id="cups-oauth-1.environment-variables">Environment Variables</h2>
+<p>The
+<strong>CUPS_OAUTH_URI</strong>
+environment variable sets the default OAuth/OpenID authorization server URL.
+</p>
+ <p>The
+<strong>CUPS_OAUTH_SCOPES</strong>
+environment variable sets the default OAuth/OpenID scopes as a space-delimited list.
+</p>
+ <h2 id="cups-oauth-1.notes">Notes</h2>
+<p>CUPS uses a redirect URI of "<a href="http://127.0.0.1/"">http://127.0.0.1/"</a> for all authorization on the local system.
+</p>
+ <h2 id="cups-oauth-1.examples">Examples</h2>
+<p>TBD
+</p>
+ <h2 id="cups-oauth-1.see-also">See Also</h2>
+<p><strong>cups</strong>(1)
+
+</p>
+ <h2 id="cups-oauth-1.copyright">Copyright</h2>
+<p>Copyright © 2025 by OpenPrinting.
+ </body>
+</html>
--- /dev/null
+<!DOCTYPE html>
+<html>
+ <head>
+ <style><!--
+body {
+ font-family: sans-serif;
+ font-size: 16pt;
+ margin: 54pt 36pt;
+}
+.center {
+ text-align: center;
+}
+a:link, a:visited {
+ color: #c00;
+ text-decoration: underline;
+}
+
+a:link:hover, a:active {
+ color: #f00;
+ text-decoration: underline;
+}
+code, kbd, pre, tt {
+ font-family: monospace;
+}
+dl {
+ margin-left: 2em;
+}
+h2, h3 {
+ border-bottom: solid 2px black;
+}
+h4 {
+ border-bottom: solid 1px black;
+}
+p {
+ text-align: justify;
+}
+span.info {
+ background: #ddf;
+ border: solid 1px #77c;
+ border-top-left-radius: 5px;
+ border-top-right-radius: 5px;
+ float: right;
+ font-size: 80%;
+ padding: 2px 10px;
+}
+h4 span.info {
+ padding: 1px 8px;
+}
+table {
+ border-collapse: collapse;
+ margin-left: auto;
+ margin-right: auto;
+ max-width: 90%;
+}
+table thead th {
+ border-bottom: solid 2px black;
+ padding: 0 10px;
+ text-align: left;
+ vertical-align: bottom;
+}
+table tbody tr:nth-child(even) {
+ background: #ddd;
+}
+table tbody td {
+ border-bottom: solid 1px black;
+ padding: 4px 10px;
+ vertical-align: top;
+}
+blockquote {
+ background: #ddf;
+ border-left: solid 2px #77c;
+ margin-left: 0;
+ margin-right: 0;
+ padding: 10px;
+}
+/* Dark mode overrides */
+@media (prefers-color-scheme: dark) {
+ body {
+ background: black;
+ color: #ccc;
+ }
+ h2, h3, h4, table tbody td, table thead th {
+ border-color: #ccc;
+ }
+ blockquote, span.info {
+ background: #337;
+ border-color: #66f;
+ }
+ table tbody tr:nth-child(even) {
+ background: #444;
+ }
+}
+--></style>
+ <meta name="creator" content="mantohtml v2.0.2">
+ <title>cups-x509(1)</title>
+ </head>
+ <body>
+ <h1 id="cups-x509-1">cups-x509(1)</h1>
+ <h2 id="cups-x509-1.name">Name</h2>
+<p>cups-x509 - description
+</p>
+ <h2 id="cups-x509-1.synopsis">Synopsis</h2>
+<p><strong>cups-x509</strong>
+<strong>--help</strong>
+<br>
+<strong>cups-x509</strong>
+<strong>--version</strong>
+<br>
+<strong>cups-x509</strong>
+[
+<strong>--pin</strong>
+] [
+<strong>--require-ca</strong>
+] [
+<strong>-C</strong>
+<em>COUNTRY</em>
+] [
+<strong>-L</strong>
+<em>LOCALITY</em>
+] [
+<strong>-O</strong>
+<em>ORGANIZATION</em>
+] [
+<strong>-R</strong>
+<em>CSR-FILENAME</em>
+] [
+<strong>-S</strong>
+<em>STATE-PROVINCE</em>
+] [
+<strong>-U</strong>
+<em>ORGANIZATIONAL-UNIT</em>
+] [
+<strong>-a</strong>
+<em>SUBJECT-ALT-NAME</em>
+] [
+<strong>-d</strong>
+<em>DAYS</em>
+] [
+<strong>-p</strong>
+<em>PURPOSE</em>
+] [
+<strong>-r</strong>
+<em>ROOT-NAME</em>
+] [
+<strong>-t</strong>
+<em>TYPE</em>
+] [
+<strong>-u</strong>
+<em>USAGE</em>
+]
+<em>COMMAND</em>
+<em>[ARGUMENT(S)]</em>
+</p>
+ <h2 id="cups-x509-1.description">Description</h2>
+<p>The
+<strong>cups-x509</strong>
+utility manages X.509 certificates and certificate requests, and supports client and server tests.
+</p>
+ <h2 id="cups-x509-1.options">Options</h2>
+<p>The following options are recognized by
+<strong>cups-x509:</strong>
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--help</strong><br>
+Show program usage.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--pin</strong><br>
+Pin the server's X.509 certificate found by the client command.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--require-ca</strong><br>
+Require the server's X.509 certificate found by the client command to be signed by a known CA.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>--version</strong><br>
+Show the CUPS version.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-C </strong><em>COUNTRY</em><br>
+Specify the country for new X.509 certificates and certificate requests.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-L </strong><em>LOCALITY</em><br>
+Specify the locality (city, town, etc.) for new X.509 certificates and certificate requests.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-O </strong><em>ORGANIZATION</em><br>
+Specify the organization name for new X.509 certificates and certificate requests.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-R </strong><em>CSR-FILENAME</em><br>
+Specify an X.509 certificate signing request in PEM format to be used when signing a certificate with the
+<strong>ca</strong>
+command.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-S </strong><em>STATE-PROVINCE</em><br>
+Specify the state/province name for new X.509 certificates and certificate requests.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>ORGANIZATIONAL-UNIT</em><br>
+Specify the organizational unit name for new X.509 certificates and certificate requests.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-a </strong><em>SUBJECT-ALT-NAME</em><br>
+Specify an alternate name for new X.509 certificates and certificate requests.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d </strong><em>DAYS</em><br>
+Specify the number of days before a new X.509 certificate will expire.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-p </strong><em>PURPOSE</em><br>
+Specify the purpose of the X.509 certificate or certificate request as a comma-delimited list of purposes.
+The supported purposes are "serverAuth" for TLS server authentication, "clientAuth" for TLS client authentication, "codeSigning" for executable code signing, "emailProtection" for S/MIME encryption and signing, "timeStamping" for secure timestamps, and "OCSPSigning" for Online Certificate Status Protocol services.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r </strong><em>ROOT-NAME</em><br>
+Specify the common name of the X.509 root certificate to use.
+The default root certificate is named "_site_".
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-t </strong><em>TYPE</em><br>
+Specify the certificate type - "rsa-2048" for 2048-bit RSA, "rsa-3072" for 3072-bit RSA, "rsa-4096" for 4096-bit RSA, "ecdsa-p256" for 256-bit ECDSA, "ecdsa-p384" for 384-bit ECDSA, or "ecdsa-p521" for 521-bit ECDSA.
+</p>
+ <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-u </strong><em>USAGE</em><br>
+Specify the usage for the certificate as a comma-delimited list of uses.
+The supported uses are "digitalSignature", "nonRepudiation", "keyEncipherment", "dataEncipherment", "keyAgreement", "keyCertSign", "cRLSign", "encipherOnly", and "decipherOnly".
+The preset "default-ca" specifies those uses required for a Certificate Authority, and the preset "default-tls" specifies those uses required for TLS.
+</p>
+ <h2 id="cups-x509-1.commands">Commands</h2>
+ <h3 id="cups-x509-1.commands.ca-common-name">Ca Common-Name</h3>
+<p>Sign a certificate request for the specified common name.
+</p>
+ <h3 id="cups-x509-1.commands.cacert-common-name">Cacert Common-Name</h3>
+<p>Create a CA certificate for the specified common name.
+</p>
+ <h3 id="cups-x509-1.commands.cert-common-name">Cert Common-Name</h3>
+<p>Create a certificate for the specified common name.
+</p>
+ <h3 id="cups-x509-1.commands.client-uri">Client Uri</h3>
+<p>Connect to the specified URI and validate the server's certificate.
+</p>
+ <h3 id="cups-x509-1.commands.csr-common-name">Csr Common-Name</h3>
+<p>Create a certificate signing request for the specified common name.
+</p>
+ <h3 id="cups-x509-1.commands.server-common-nameport">Server Common-Name[:Port]</h3>
+<p>Run a HTTPS test server that echos back the resource path for every GET request.
+If PORT is not specified, uses a port number from 8000 to 8999.
+</p>
+ <h3 id="cups-x509-1.commands.show-common-name">Show Common-Name</h3>
+<p>Shows any stored credentials for the specified common name.
+</p>
+ <h2 id="cups-x509-1.examples">Examples</h2>
+<p>TBD
+</p>
+ <h2 id="cups-x509-1.see-also">See Also</h2>
+<p><strong>cups</strong>(1)
+
+</p>
+ <h2 id="cups-x509-1.copyright">Copyright</h2>
+<p>Copyright © 2025 by OpenPrinting.
+ </body>
+</html>
<br>
The "scopes" parameter specifies zero or more whitespace-delimited scope
names to request during authorization. The list of supported scope names are
-available from the Authorization Server metadata, for example:<br>
-<br>
-The "redirect_uri" parameter specifies a 'http:' URL with a listen address,
-port, and path to use. If <code>NULL</code>, 127.0.0.1 on a random port is used with a
-path of "/".
+available from the Authorization Server metadata, for example:
<pre>
cups_json_t *metadata = cupsOAuthGetMetadata(auth_uri);
cups_json_t *scopes_supported = cupsJSONFind(metadata, "scopes_supported");
</pre>
+The "redirect_uri" parameter specifies a 'http:' URL with a listen address,
+port, and path to use. If <code>NULL</code>, 127.0.0.1 on a random port is used with a
+path of "/".<br>
+<br>
The returned authorization code must be freed using the <code>free</code> function.</p>
<h3 class="function"><a id="cupsOAuthGetClientId">cupsOAuthGetClientId</a></h3>
<p class="description">Register a client application and get its ID.</p>
<h2>Man Pages</h2>
<ul>
+ <li>client.conf(5) - client configuration file for cups: <a href="client.conf.html">HTML</a></li>
+ <li>cups-oauth(1) - Interact with an OAuth/OpenID Authorization Server: <a href="cups-oauth.html">HTML</a></li>
+ <li>cups-x509(1) - Manage X.509 Certificates and Certificate Requests: <a href="cups-x509.html">HTML</a></li>
<li>ippeveprinter(1) - An IPP Everywhere Printer Application for CUPS: <a href="ippeveprinter.html">HTML</a></li>
<li>ippfind(1) - Find Internet Printing Protocol Printers: <a href="ippfind.html">HTML</a></li>
<li>ipptool(1) - Perform Internet Printing Protocol Requests: <a href="ipptool.html">HTML</a></li>
<li>CUPS Implementation of IPP: <a href="spec-ipp.html">HTML</a></li>
<li>CUPS Programming Manual: <a href="cupspm.html">HTML</a> · <a href="cupspm.epub">EPUB</a></li>
<li>CUPS Raster Format: <a href="spec-raster.html">HTML</a></li>
+ <li>libcups(3) - CUPS API Library: <a href="libcups.html">HTML</a></li>
</ul>
</body>
</html>
--- /dev/null
+<!DOCTYPE html>
+<html>
+ <head>
+ <style><!--
+body {
+ font-family: sans-serif;
+ font-size: 16pt;
+ margin: 54pt 36pt;
+}
+.center {
+ text-align: center;
+}
+a:link, a:visited {
+ color: #c00;
+ text-decoration: underline;
+}
+
+a:link:hover, a:active {
+ color: #f00;
+ text-decoration: underline;
+}
+code, kbd, pre, tt {
+ font-family: monospace;
+}
+dl {
+ margin-left: 2em;
+}
+h2, h3 {
+ border-bottom: solid 2px black;
+}
+h4 {
+ border-bottom: solid 1px black;
+}
+p {
+ text-align: justify;
+}
+span.info {
+ background: #ddf;
+ border: solid 1px #77c;
+ border-top-left-radius: 5px;
+ border-top-right-radius: 5px;
+ float: right;
+ font-size: 80%;
+ padding: 2px 10px;
+}
+h4 span.info {
+ padding: 1px 8px;
+}
+table {
+ border-collapse: collapse;
+ margin-left: auto;
+ margin-right: auto;
+ max-width: 90%;
+}
+table thead th {
+ border-bottom: solid 2px black;
+ padding: 0 10px;
+ text-align: left;
+ vertical-align: bottom;
+}
+table tbody tr:nth-child(even) {
+ background: #ddd;
+}
+table tbody td {
+ border-bottom: solid 1px black;
+ padding: 4px 10px;
+ vertical-align: top;
+}
+blockquote {
+ background: #ddf;
+ border-left: solid 2px #77c;
+ margin-left: 0;
+ margin-right: 0;
+ padding: 10px;
+}
+/* Dark mode overrides */
+@media (prefers-color-scheme: dark) {
+ body {
+ background: black;
+ color: #ccc;
+ }
+ h2, h3, h4, table tbody td, table thead th {
+ border-color: #ccc;
+ }
+ blockquote, span.info {
+ background: #337;
+ border-color: #66f;
+ }
+ table tbody tr:nth-child(even) {
+ background: #444;
+ }
+}
+--></style>
+ <meta name="creator" content="mantohtml v2.0.2">
+ <title>libcups(3)</title>
+ </head>
+ <body>
+ <h1 id="libcups-3">libcups(3)</h1>
+ <h2 id="libcups-3.name">Name</h2>
+<p>libcups - cups api library
+</p>
+ <h2 id="libcups-3.description">Description</h2>
+ <h2 id="libcups-3.see-also">See Also</h2>
+<p><strong>cups</strong>(1)
+
+</p>
+ <h2 id="libcups-3.copyright">Copyright</h2>
+<p>Copyright © 2025 by OpenPrinting.
+ </body>
+</html>
projects / thirdparty / cups.git / commitdiff
