From 3bd3849715f61b48c3766eeede670665315dc8a9 Mon Sep 17 00:00:00 2001 From: Michael R Sweet Date: Thu, 8 Nov 2018 09:29:13 -0500 Subject: [PATCH] Deprecate snmp backend. --- CHANGES.md | 1 + man/cups-snmp.conf.man | 7 ++++--- man/cups-snmp.man.in | 12 ++++++++---- 3 files changed, 13 insertions(+), 7 deletions(-) diff --git a/CHANGES.md b/CHANGES.md index e4689c8a1..a6ede3f31 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -46,6 +46,7 @@ Changes in CUPS v2.3b6 - Fixed a memory leak for some IPP (extension) syntaxes. - The `cupscgi`, `cupsmime`, and `cupsppdc` support libraries are no longer installed as shared libraries. +- The `snmp` backend is now deprecated. Changes in CUPS v2.3b5 diff --git a/man/cups-snmp.conf.man b/man/cups-snmp.conf.man index 23e7eb849..8cc273c5c 100644 --- a/man/cups-snmp.conf.man +++ b/man/cups-snmp.conf.man @@ -1,10 +1,11 @@ .\" .\" snmp.conf man page for CUPS. .\" -.\" Copyright 2007-2014 by Apple Inc. -.\" Copyright 2006 by Easy Software Products. +.\" Copyright © 2007-2018 by Apple Inc. +.\" Copyright © 2006 by Easy Software Products. .\" -.\" Licensed under Apache License v2.0. See the file "LICENSE" for more information. +.\" Licensed under Apache License v2.0. See the file "LICENSE" for more +.\" information. .\" .TH snmp.conf 5 "CUPS" "8 November 2018" "Apple Inc." .SH NAME diff --git a/man/cups-snmp.man.in b/man/cups-snmp.man.in index 031fa0a7a..b875bbf83 100644 --- a/man/cups-snmp.man.in +++ b/man/cups-snmp.man.in @@ -1,11 +1,12 @@ .\" .\" SNMP backend man page for CUPS. .\" -.\" Copyright 2012-2014 by Apple Inc. +.\" Copyright © 2012-2018 by Apple Inc. .\" -.\" Licensed under Apache License v2.0. See the file "LICENSE" for more information. +.\" Licensed under Apache License v2.0. See the file "LICENSE" for more +.\" information. .\" -.TH cups-snmp 8 "CUPS" "10 June 2014" "Apple Inc." +.TH cups-snmp 8 "CUPS" "8 November 2018" "Apple Inc." .SH NAME snmp \- cups snmp backend .SH SYNOPSIS @@ -20,7 +21,7 @@ snmp \- cups snmp backend .B \-\-include-schemes snmp .SH DESCRIPTION -The CUPS SNMP backend provides legacy discovery and identification of network printers using SNMPv1. +The \fBDEPRECATED\fR CUPS SNMP backend provides legacy discovery and identification of network printers using SNMPv1. When used for discovery through the scheduler, the backend will list all printers that respond to a broadcast SNMPv1 query with the "public" community name. Additional queries are then sent to printers that respond in order to determine the correct device URI, make and model, and other information needed for printing. .LP @@ -40,6 +41,9 @@ The MaxRunTime value can be overridden using the CUPS_MAX_RUN_TIME environment v The SNMP backend reads the \fI/etc/cups/snmp.conf\fR configuration file, if present, to set the default broadcast address, community name, and logging level. +.SH NOTES +The CUPS SNMP backend is deprecated and will no longer be supported in a future +version of CUPS. .SH CONFORMING TO The CUPS SNMP backend uses the information from the Host, Printer, and Port Monitor MIBs along with some vendor private MIBs and intelligent port probes to determine the correct device URI and make and model for each printer. .SH SEE ALSO -- 2.39.5