BUILDROOT = $(DSTROOT)$(DESTDIR)
-AMANDIR = $(BUILDROOT)@AMANDIR@
BINDIR = $(BUILDROOT)@bindir@
BUNDLEDIR = @CUPS_BUNDLEDIR@
CACHEDIR = $(BUILDROOT)@CUPS_CACHEDIR@
LOGDIR = $(BUILDROOT)@CUPS_LOGDIR@
MANDIR = $(BUILDROOT)@mandir@
MENUDIR = @MENUDIR@
-PMANDIR = $(BUILDROOT)@PMANDIR@
PRIVATEINCLUDE = $(BUILDROOT)@PRIVATEINCLUDE@
RCLEVELS = @RCLEVELS@
RCSTART = @RCSTART@
SERVERROOT = $(BUILDROOT)@CUPS_SERVERROOT@
STATEDIR = $(BUILDROOT)@CUPS_STATEDIR@
-MAN1EXT = @MAN1EXT@
-MAN5EXT = @MAN5EXT@
-MAN7EXT = @MAN7EXT@
-MAN8EXT = @MAN8EXT@
-MAN8DIR = @MAN8DIR@
-
PAMDIR = @PAMDIR@
PAMFILE = @PAMFILE@
$(RM) Makedefs config.h config.log config.status
$(RM) conf/cups-files.conf conf/cupsd.conf conf/mime.convs conf/pam.std conf/snmp.conf
$(RM) cups-config
- $(RM) data/testprint
$(RM) desktop/cups.desktop
$(RM) doc/index.html
- $(RM) man/client.conf.man man/cups-files.conf.man man/cups-lpd.man man/cups-snmp.man man/cupsaddsmb.man man/cupsd.conf.man man/cupsd.man man/lpoptions.man
$(RM) packaging/cups.list
$(RM) scheduler/cups-lpd.xinetd scheduler/cups.sh scheduler/cups.xml scheduler/org.cups.cups-lpd.plist scheduler/org.cups.cups-lpdAT.service scheduler/org.cups.cupsd.path scheduler/org.cups.cupsd.service scheduler/org.cups.cupsd.socket
$(RM) templates/header.tmpl
-$(RM) doc/*/index.html
-$(RM) templates/*/header.tmpl
- -$(RM) -r autom4te*.cache clang cups/charmaps cups/locale
+ -$(RM) -r autom4te*.cache cups/charmaps cups/locale
#
done
-#
-# Run the Clang static code analysis tool on the sources, available here:
-#
-# http://clang-analyzer.llvm.org
-#
-# At least checker-231 is required.
-#
-# Alternatively, use "--analyze -Xanalyzer -analyzer-output=text" for OPTIM (text
-# output instead of HTML...)
-#
-
-.PHONY: clang clang-changes
-clang:
- $(RM) -r clang
- scan-build -V -k -o `pwd`/clang $(MAKE) $(MFLAGS) clean all
-clang-changes:
- scan-build -V -k -o `pwd`/clang $(MAKE) $(MFLAGS) all
-
-
#
# Run the STACK tool on the sources, available here:
#
DNSSDLIBS="`$PKGCONFIG --libs avahi-client`"
DNSSD_BACKEND="dnssd"
IPPFIND_BIN="ippfind"
- IPPFIND_MAN="ippfind.\$(MAN1EXT)"
+ IPPFIND_MAN="ippfind.1)"
AC_DEFINE(HAVE_AVAHI)
else
AC_MSG_RESULT(no)
AC_DEFINE(HAVE_DNSSD)
DNSSD_BACKEND="dnssd"
IPPFIND_BIN="ippfind"
- IPPFIND_MAN="ippfind.\$(MAN1EXT)"
+ IPPFIND_MAN="ippfind.1"
;;
*)
# All others...
DNSSDLIBS="-ldns_sd"
DNSSD_BACKEND="dnssd",
IPPFIND_BIN="ippfind"
- IPPFIND_MAN="ippfind.\$(MAN1EXT)"
+ IPPFIND_MAN="ippfind.1"
AC_MSG_RESULT(no))
LIBS="$SAVELIBS"
;;
dnl
dnl Manpage stuff for CUPS.
dnl
-dnl Copyright 2007-2017 by Apple Inc.
-dnl Copyright 1997-2006 by Easy Software Products, all rights reserved.
+dnl Copyright © 2007-2019 by Apple Inc.
+dnl Copyright © 1997-2006 by Easy Software Products, all rights reserved.
dnl
-dnl Licensed under Apache License v2.0. See the file "LICENSE" for more information.
+dnl Licensed under Apache License v2.0. See the file "LICENSE" for more
+dnl information.
dnl
dnl Fix "mandir" variable...
darwin* | linux* | gnu* | *bsd*)
# Darwin, macOS, Linux, GNU HURD, and *BSD
mandir="/usr/share/man"
- AMANDIR="/usr/share/man"
- PMANDIR="/usr/share/man"
;;
*)
# All others
mandir="/usr/man"
- AMANDIR="/usr/man"
- PMANDIR="/usr/man"
;;
esac
-else
- AMANDIR="$mandir"
- PMANDIR="$mandir"
fi
-
-AC_SUBST(AMANDIR)
-AC_SUBST(PMANDIR)
-
-dnl Setup manpage extensions...
-case "$host_os_name" in
- sunos*)
- # Solaris
- MAN1EXT=1
- MAN5EXT=5
- MAN7EXT=7
- MAN8EXT=1m
- MAN8DIR=1m
- ;;
- linux* | gnu* | darwin*)
- # Linux, GNU Hurd, and macOS
- MAN1EXT=1.gz
- MAN5EXT=5.gz
- MAN7EXT=7.gz
- MAN8EXT=8.gz
- MAN8DIR=8
- ;;
- *)
- # All others
- MAN1EXT=1
- MAN5EXT=5
- MAN7EXT=7
- MAN8EXT=8
- MAN8DIR=8
- ;;
-esac
-
-AC_SUBST(MAN1EXT)
-AC_SUBST(MAN5EXT)
-AC_SUBST(MAN7EXT)
-AC_SUBST(MAN8EXT)
-AC_SUBST(MAN8DIR)
#! /bin/sh
# Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.68 for CUPS 2.3b7.
+# Generated by GNU Autoconf 2.69 for CUPS 2.3b7.
#
# Report bugs to <https://github.com/apple/cups/issues>.
#
#
-# Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001,
-# 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software
-# Foundation, Inc.
+# Copyright (C) 1992-1996, 1998-2012 Free Software Foundation, Inc.
#
#
# This configure script is free software; the Free Software Foundation
# CDPATH.
(unset CDPATH) >/dev/null 2>&1 && unset CDPATH
+# Use a proper internal environment variable to ensure we don't fall
+ # into an infinite loop, continuously re-executing ourselves.
+ if test x"${_as_can_reexec}" != xno && test "x$CONFIG_SHELL" != x; then
+ _as_can_reexec=no; export _as_can_reexec;
+ # We cannot yet assume a decent shell, so we have to provide a
+# neutralization value for shells without unset; and this also
+# works around shells that cannot unset nonexistent variables.
+# Preserve -v and -x to the replacement shell.
+BASH_ENV=/dev/null
+ENV=/dev/null
+(unset BASH_ENV) >/dev/null 2>&1 && unset BASH_ENV ENV
+case $- in # ((((
+ *v*x* | *x*v* ) as_opts=-vx ;;
+ *v* ) as_opts=-v ;;
+ *x* ) as_opts=-x ;;
+ * ) as_opts= ;;
+esac
+exec $CONFIG_SHELL $as_opts "$as_myself" ${1+"$@"}
+# Admittedly, this is quite paranoid, since all the known shells bail
+# out after a failed `exec'.
+$as_echo "$0: could not re-execute with $CONFIG_SHELL" >&2
+as_fn_exit 255
+ fi
+ # We don't want this to propagate to other subprocesses.
+ { _as_can_reexec=; unset _as_can_reexec;}
if test "x$CONFIG_SHELL" = x; then
as_bourne_compatible="if test -n \"\${ZSH_VERSION+set}\" && (emulate sh) >/dev/null 2>&1; then :
emulate sh
else
exitcode=1; echo positional parameters were not saved.
fi
-test x\$exitcode = x0 || exit 1"
+test x\$exitcode = x0 || exit 1
+test -x / || exit 1"
as_suggested=" as_lineno_1=";as_suggested=$as_suggested$LINENO;as_suggested=$as_suggested" as_lineno_1a=\$LINENO
as_lineno_2=";as_suggested=$as_suggested$LINENO;as_suggested=$as_suggested" as_lineno_2a=\$LINENO
eval 'test \"x\$as_lineno_1'\$as_run'\" != \"x\$as_lineno_2'\$as_run'\" &&
if test "x$CONFIG_SHELL" != x; then :
- # We cannot yet assume a decent shell, so we have to provide a
- # neutralization value for shells without unset; and this also
- # works around shells that cannot unset nonexistent variables.
- # Preserve -v and -x to the replacement shell.
- BASH_ENV=/dev/null
- ENV=/dev/null
- (unset BASH_ENV) >/dev/null 2>&1 && unset BASH_ENV ENV
- export CONFIG_SHELL
- case $- in # ((((
- *v*x* | *x*v* ) as_opts=-vx ;;
- *v* ) as_opts=-v ;;
- *x* ) as_opts=-x ;;
- * ) as_opts= ;;
- esac
- exec "$CONFIG_SHELL" $as_opts "$as_myself" ${1+"$@"}
+ export CONFIG_SHELL
+ # We cannot yet assume a decent shell, so we have to provide a
+# neutralization value for shells without unset; and this also
+# works around shells that cannot unset nonexistent variables.
+# Preserve -v and -x to the replacement shell.
+BASH_ENV=/dev/null
+ENV=/dev/null
+(unset BASH_ENV) >/dev/null 2>&1 && unset BASH_ENV ENV
+case $- in # ((((
+ *v*x* | *x*v* ) as_opts=-vx ;;
+ *v* ) as_opts=-v ;;
+ *x* ) as_opts=-x ;;
+ * ) as_opts= ;;
+esac
+exec $CONFIG_SHELL $as_opts "$as_myself" ${1+"$@"}
+# Admittedly, this is quite paranoid, since all the known shells bail
+# out after a failed `exec'.
+$as_echo "$0: could not re-execute with $CONFIG_SHELL" >&2
+exit 255
fi
if test x$as_have_required = xno; then :
} # as_fn_mkdir_p
+
+# as_fn_executable_p FILE
+# -----------------------
+# Test if FILE is an executable regular file.
+as_fn_executable_p ()
+{
+ test -f "$1" && test -x "$1"
+} # as_fn_executable_p
# as_fn_append VAR VALUE
# ----------------------
# Append the text in VALUE to the end of the definition contained in VAR. Take
chmod +x "$as_me.lineno" ||
{ $as_echo "$as_me: error: cannot create $as_me.lineno; rerun with a POSIX shell" >&2; as_fn_exit 1; }
+ # If we had to re-execute with $CONFIG_SHELL, we're ensured to have
+ # already done that, so ensure we don't try to do so again and fall
+ # in an infinite loop. This has already happened in practice.
+ _as_can_reexec=no; export _as_can_reexec
# Don't try to exec as it changes $[0], causing all sort of problems
# (the dirname of $[0] is not the place where we might find the
# original and so on. Autoconf is especially sensitive to this).
# ... but there are two gotchas:
# 1) On MSYS, both `ln -s file dir' and `ln file dir' fail.
# 2) DJGPP < 2.04 has no symlinks; `ln -s' creates a wrapper executable.
- # In both cases, we have to default to `cp -p'.
+ # In both cases, we have to default to `cp -pR'.
ln -s conf$$.file conf$$.dir 2>/dev/null && test ! -f conf$$.exe ||
- as_ln_s='cp -p'
+ as_ln_s='cp -pR'
elif ln conf$$.file conf$$ 2>/dev/null; then
as_ln_s=ln
else
- as_ln_s='cp -p'
+ as_ln_s='cp -pR'
fi
else
- as_ln_s='cp -p'
+ as_ln_s='cp -pR'
fi
rm -f conf$$ conf$$.exe conf$$.dir/conf$$.file conf$$.file
rmdir conf$$.dir 2>/dev/null
as_mkdir_p=false
fi
-if test -x / >/dev/null 2>&1; then
- as_test_x='test -x'
-else
- if ls -dL / >/dev/null 2>&1; then
- as_ls_L_option=L
- else
- as_ls_L_option=
- fi
- as_test_x='
- eval sh -c '\''
- if test -d "$1"; then
- test -d "$1/.";
- else
- case $1 in #(
- -*)set "./$1";;
- esac;
- case `ls -ld'$as_ls_L_option' "$1" 2>/dev/null` in #((
- ???[sx]*):;;*)false;;esac;fi
- '\'' sh
- '
-fi
-as_executable_p=$as_test_x
+as_test_x='test -x'
+as_executable_p=as_fn_executable_p
# Sed expression to map a string onto a valid CPP name.
as_tr_cpp="eval sed 'y%*$as_cr_letters%P$as_cr_LETTERS%;s%[^_$as_cr_alnum]%_%g'"
DSOFLAGS
DSOXX
DSO
-MAN8DIR
-MAN8EXT
-MAN7EXT
-MAN5EXT
-MAN1EXT
-PMANDIR
-AMANDIR
CUPS_STATEDIR
CUPS_SERVERROOT
INSTALL_SYSV
if test "x$host_alias" != x; then
if test "x$build_alias" = x; then
cross_compiling=maybe
- $as_echo "$as_me: WARNING: if you wanted to set the --build type, don't use --host.
- If a cross compiler is detected then cross compile mode will be used" >&2
elif test "x$build_alias" != "x$host_alias"; then
cross_compiling=yes
fi
if $ac_init_version; then
cat <<\_ACEOF
CUPS configure 2.3b7
-generated by GNU Autoconf 2.68
+generated by GNU Autoconf 2.69
-Copyright (C) 2010 Free Software Foundation, Inc.
+Copyright (C) 2012 Free Software Foundation, Inc.
This configure script is free software; the Free Software Foundation
gives unlimited permission to copy, distribute and modify it.
_ACEOF
test ! -s conftest.err
} && test -s conftest$ac_exeext && {
test "$cross_compiling" = yes ||
- $as_test_x conftest$ac_exeext
+ test -x conftest$ac_exeext
}; then :
ac_retval=0
else
running configure, to aid debugging if configure makes a mistake.
It was created by CUPS $as_me 2.3b7, which was
-generated by GNU Autoconf 2.68. Invocation command line was
+generated by GNU Autoconf 2.69. Invocation command line was
$ $0 $@
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_CODE_SIGN="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_prog_AWK="$ac_prog"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_prog_CC="$ac_tool_prefix$ac_prog"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_prog_ac_ct_CC="$ac_prog"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
/* end confdefs.h. */
#include <stdarg.h>
#include <stdio.h>
-#include <sys/types.h>
-#include <sys/stat.h>
+struct stat;
/* Most of the following tests are stolen from RCS 5.7's src/conf.sh. */
struct buf { int x; };
FILE * (*rcsopen) (struct buf *, struct stat *, int);
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_prog_CXX="$ac_tool_prefix$ac_prog"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_prog_ac_ct_CXX="$ac_prog"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_prog_RANLIB="${ac_tool_prefix}ranlib"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_prog_ac_ct_RANLIB="ranlib"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_AR="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_CHMOD="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_GZIP="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_LD="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_LN="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_MKDIR="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_MV="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_RM="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_RMDIR="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_SED="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_XDGOPEN="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_PKGCONFIG="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_ac_pt_PKGCONFIG="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
for ac_prog in grep ggrep; do
for ac_exec_ext in '' $ac_executable_extensions; do
ac_path_GREP="$as_dir/$ac_prog$ac_exec_ext"
- { test -f "$ac_path_GREP" && $as_test_x "$ac_path_GREP"; } || continue
+ as_fn_executable_p "$ac_path_GREP" || continue
# Check for GNU ac_path_GREP and select it if it is found.
# Check for GNU $ac_path_GREP
case `"$ac_path_GREP" --version 2>&1` in
for ac_prog in egrep; do
for ac_exec_ext in '' $ac_executable_extensions; do
ac_path_EGREP="$as_dir/$ac_prog$ac_exec_ext"
- { test -f "$ac_path_EGREP" && $as_test_x "$ac_path_EGREP"; } || continue
+ as_fn_executable_p "$ac_path_EGREP" || continue
# Check for GNU ac_path_EGREP and select it if it is found.
# Check for GNU $ac_path_EGREP
case `"$ac_path_EGREP" --version 2>&1` in
darwin* | linux* | gnu* | *bsd*)
# Darwin, macOS, Linux, GNU HURD, and *BSD
mandir="/usr/share/man"
- AMANDIR="/usr/share/man"
- PMANDIR="/usr/share/man"
;;
*)
# All others
mandir="/usr/man"
- AMANDIR="/usr/man"
- PMANDIR="/usr/man"
;;
esac
-else
- AMANDIR="$mandir"
- PMANDIR="$mandir"
fi
-
-case "$host_os_name" in
- sunos*)
- # Solaris
- MAN1EXT=1
- MAN5EXT=5
- MAN7EXT=7
- MAN8EXT=1m
- MAN8DIR=1m
- ;;
- linux* | gnu* | darwin*)
- # Linux, GNU Hurd, and macOS
- MAN1EXT=1.gz
- MAN5EXT=5.gz
- MAN7EXT=7.gz
- MAN8EXT=8.gz
- MAN8DIR=8
- ;;
- *)
- # All others
- MAN1EXT=1
- MAN5EXT=5
- MAN7EXT=7
- MAN8EXT=8
- MAN8DIR=8
- ;;
-esac
-
-
-
-
-
-
-
-
-
PICFLAG=1
DSOFLAGS="${DSOFLAGS:=}"
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_KRB5CONFIG="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_ac_pt_KRB5CONFIG="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_LIBGNUTLSCONFIG="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
IFS=$as_save_IFS
test -z "$as_dir" && as_dir=.
for ac_exec_ext in '' $ac_executable_extensions; do
- if { test -f "$as_dir/$ac_word$ac_exec_ext" && $as_test_x "$as_dir/$ac_word$ac_exec_ext"; }; then
+ if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
ac_cv_path_ac_pt_LIBGNUTLSCONFIG="$as_dir/$ac_word$ac_exec_ext"
$as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
break 2
esac
rm -rf conftest*
fi
+
+
fi
DNSSDLIBS="`$PKGCONFIG --libs avahi-client`"
DNSSD_BACKEND="dnssd"
IPPFIND_BIN="ippfind"
- IPPFIND_MAN="ippfind.\$(MAN1EXT)"
+ IPPFIND_MAN="ippfind.1)"
$as_echo "#define HAVE_AVAHI 1" >>confdefs.h
else
DNSSD_BACKEND="dnssd"
IPPFIND_BIN="ippfind"
- IPPFIND_MAN="ippfind.\$(MAN1EXT)"
+ IPPFIND_MAN="ippfind.1"
;;
*)
# All others...
DNSSD_BACKEND="dnssd"
else
IPPFIND_BIN="ippfind"
- IPPFIND_MAN="ippfind.\$(MAN1EXT)"
+ IPPFIND_MAN="ippfind.1"
{ $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
$as_echo "no" >&6; }
fi
-ac_config_files="$ac_config_files Makedefs conf/cups-files.conf conf/cupsd.conf conf/mime.convs conf/pam.std conf/snmp.conf cups-config desktop/cups.desktop doc/index.html man/client.conf.man man/cups-files.conf.man man/cups-lpd.man man/cups-snmp.man man/cupsd.conf.man man/cupsd.man man/lpoptions.man scheduler/cups-lpd.xinetd scheduler/cups.sh scheduler/cups.xml scheduler/org.cups.cups-lpd.plist scheduler/org.cups.cups-lpdAT.service scheduler/org.cups.cupsd.path scheduler/org.cups.cupsd.service scheduler/org.cups.cupsd.socket templates/header.tmpl packaging/cups.list $LANGFILES"
+ac_config_files="$ac_config_files Makedefs conf/cups-files.conf conf/cupsd.conf conf/mime.convs conf/pam.std conf/snmp.conf cups-config desktop/cups.desktop doc/index.html scheduler/cups-lpd.xinetd scheduler/cups.sh scheduler/cups.xml scheduler/org.cups.cups-lpd.plist scheduler/org.cups.cups-lpdAT.service scheduler/org.cups.cupsd.path scheduler/org.cups.cupsd.service scheduler/org.cups.cupsd.socket templates/header.tmpl packaging/cups.list $LANGFILES"
cat >confcache <<\_ACEOF
# This file is a shell script that caches the results of configure
# ... but there are two gotchas:
# 1) On MSYS, both `ln -s file dir' and `ln file dir' fail.
# 2) DJGPP < 2.04 has no symlinks; `ln -s' creates a wrapper executable.
- # In both cases, we have to default to `cp -p'.
+ # In both cases, we have to default to `cp -pR'.
ln -s conf$$.file conf$$.dir 2>/dev/null && test ! -f conf$$.exe ||
- as_ln_s='cp -p'
+ as_ln_s='cp -pR'
elif ln conf$$.file conf$$ 2>/dev/null; then
as_ln_s=ln
else
- as_ln_s='cp -p'
+ as_ln_s='cp -pR'
fi
else
- as_ln_s='cp -p'
+ as_ln_s='cp -pR'
fi
rm -f conf$$ conf$$.exe conf$$.dir/conf$$.file conf$$.file
rmdir conf$$.dir 2>/dev/null
as_mkdir_p=false
fi
-if test -x / >/dev/null 2>&1; then
- as_test_x='test -x'
-else
- if ls -dL / >/dev/null 2>&1; then
- as_ls_L_option=L
- else
- as_ls_L_option=
- fi
- as_test_x='
- eval sh -c '\''
- if test -d "$1"; then
- test -d "$1/.";
- else
- case $1 in #(
- -*)set "./$1";;
- esac;
- case `ls -ld'$as_ls_L_option' "$1" 2>/dev/null` in #((
- ???[sx]*):;;*)false;;esac;fi
- '\'' sh
- '
-fi
-as_executable_p=$as_test_x
+
+# as_fn_executable_p FILE
+# -----------------------
+# Test if FILE is an executable regular file.
+as_fn_executable_p ()
+{
+ test -f "$1" && test -x "$1"
+} # as_fn_executable_p
+as_test_x='test -x'
+as_executable_p=as_fn_executable_p
# Sed expression to map a string onto a valid CPP name.
as_tr_cpp="eval sed 'y%*$as_cr_letters%P$as_cr_LETTERS%;s%[^_$as_cr_alnum]%_%g'"
# values after options handling.
ac_log="
This file was extended by CUPS $as_me 2.3b7, which was
-generated by GNU Autoconf 2.68. Invocation command line was
+generated by GNU Autoconf 2.69. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
CONFIG_HEADERS = $CONFIG_HEADERS
ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
ac_cs_version="\\
CUPS config.status 2.3b7
-configured by $0, generated by GNU Autoconf 2.68,
+configured by $0, generated by GNU Autoconf 2.69,
with options \\"\$ac_cs_config\\"
-Copyright (C) 2010 Free Software Foundation, Inc.
+Copyright (C) 2012 Free Software Foundation, Inc.
This config.status script is free software; the Free Software Foundation
gives unlimited permission to copy, distribute and modify it."
_ACEOF
cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
if \$ac_cs_recheck; then
- set X '$SHELL' '$0' $ac_configure_args \$ac_configure_extra_args --no-create --no-recursion
+ set X $SHELL '$0' $ac_configure_args \$ac_configure_extra_args --no-create --no-recursion
shift
\$as_echo "running CONFIG_SHELL=$SHELL \$*" >&6
CONFIG_SHELL='$SHELL'
"cups-config") CONFIG_FILES="$CONFIG_FILES cups-config" ;;
"desktop/cups.desktop") CONFIG_FILES="$CONFIG_FILES desktop/cups.desktop" ;;
"doc/index.html") CONFIG_FILES="$CONFIG_FILES doc/index.html" ;;
- "man/client.conf.man") CONFIG_FILES="$CONFIG_FILES man/client.conf.man" ;;
- "man/cups-files.conf.man") CONFIG_FILES="$CONFIG_FILES man/cups-files.conf.man" ;;
- "man/cups-lpd.man") CONFIG_FILES="$CONFIG_FILES man/cups-lpd.man" ;;
- "man/cups-snmp.man") CONFIG_FILES="$CONFIG_FILES man/cups-snmp.man" ;;
- "man/cupsd.conf.man") CONFIG_FILES="$CONFIG_FILES man/cupsd.conf.man" ;;
- "man/cupsd.man") CONFIG_FILES="$CONFIG_FILES man/cupsd.man" ;;
- "man/lpoptions.man") CONFIG_FILES="$CONFIG_FILES man/lpoptions.man" ;;
"scheduler/cups-lpd.xinetd") CONFIG_FILES="$CONFIG_FILES scheduler/cups-lpd.xinetd" ;;
"scheduler/cups.sh") CONFIG_FILES="$CONFIG_FILES scheduler/cups.sh" ;;
"scheduler/cups.xml") CONFIG_FILES="$CONFIG_FILES scheduler/cups.xml" ;;
cups-config
desktop/cups.desktop
doc/index.html
- man/client.conf.man
- man/cups-files.conf.man
- man/cups-lpd.man
- man/cups-snmp.man
- man/cupsd.conf.man
- man/cupsd.man
- man/lpoptions.man
scheduler/cups-lpd.xinetd
scheduler/cups.sh
scheduler/cups.xml
done
install-langbundle:
-
-
-#
-# Install the docset bits locally...
-#
-
-docset:
- cp $(HELPFILES) ../org.cups.docset/Contents/Resources/Documentation/help
- cp cups-printable.css ../org.cups.docset/Contents/Resources/Documentation
- cp $(HELPIMAGES) ../org.cups.docset/Contents/Resources/Documentation/images
</pre>
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
Backends are a special type of
-<a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7)</a>
+<b>filter</b>(7)
which is used to send print data to and discover different devices on the system.
<p>Like filters, backends must be capable of reading from a filename on the command-line or from the standard input, copying the standard input to a temporary file as required by the physical interface.
-<p>The command name (<i>argv[0]</i>) is set to the device URI of the destination printer. Authentication information in
+<p>The command name (<i>argv[0]</i>) is set to the device URI of the destination printer.
+Authentication information in
<i>argv[0]</i>
is removed, so backend developers are urged to use the
<b>DEVICE_URI</b>
<b>CUPS_SC_FD</b>
constant defines the file descriptor that should be monitored for incoming requests.
<h3><a name="DEVICE_DISCOVERY">Device Discovery</a></h3>
-When run with no arguments, the backend should list the devices and schemes it supports or is advertising to the standard output. The output consists of zero or more lines consisting of any of the following forms:
+When run with no arguments, the backend should list the devices and schemes it supports or is advertising to the standard output.
+The output consists of zero or more lines consisting of any of the following forms:
<pre class="man">
device-class scheme "Unknown" "device-info"
<dd style="margin-left: 5.0em">The device-uri refers to a networked device and conforms to the general form for
network URIs.
<dt><b>serial</b>
-<dd style="margin-left: 5.0em">The device-uri refers to a serial device with configurable baud rate and other options. If the device-uri contains a baud value, it represents the maximum baud rate supported by the device.
+<dd style="margin-left: 5.0em">The device-uri refers to a serial device with configurable baud rate and other options.
+If the device-uri contains a baud value, it represents the maximum baud rate supported by the device.
</dl>
<p>The
<i>scheme</i>
-field provides the URI scheme that is supported by the backend. Backends should use this form only when the backend supports any URI using that scheme. The
+field provides the URI scheme that is supported by the backend.
+Backends should use this form only when the backend supports any URI using that scheme.
+The
<i>device-uri</i>
field specifies the full URI to use when communicating with the device.
<p>The
<i>device-make-and-model</i>
-field specifies the make and model of the device, e.g. "Example Foojet 2000". If the make and model is not known, you must report "Unknown".
+field specifies the make and model of the device, e.g. "Example Foojet 2000".
+If the make and model is not known, you must report "Unknown".
<p>The
<i>device-info</i>
-field specifies additional information about the device. Typically this includes the make and model along with the port number or network address, e.g. "Example Foojet 2000 USB #1".
+field specifies additional information about the device.
+Typically this includes the make and model along with the port number or network address, e.g. "Example Foojet 2000 USB #1".
<p>The optional
<i>device-id</i>
field specifies the IEEE-1284 device ID string for the device, which is used to select a matching driver.
<i>device-location</i>
field specifies the physical location of the device, which is often used to pre-populate the printer-location attribute when adding a printer.
<h3><a name="PERMISSIONS">Permissions</a></h3>
-Backends without world read and execute permissions are run as the root user. Otherwise, the backend is run using an unprivileged user account, typically "lp".
+Backends without world read and execute permissions are run as the root user.
+Otherwise, the backend is run using an unprivileged user account, typically "lp".
<h2 class="title"><a name="EXIT_STATUS">Exit Status</a></h2>
The following exit codes are defined for backends:
<dl class="man">
<dd style="margin-left: 5.0em">The print file was successfully transmitted to the device or remote server.
<dt><b>CUPS_BACKEND_FAILED</b>
<dd style="margin-left: 5.0em"><br>
-The print file was not successfully transmitted to the device or remote server. The scheduler will respond to this by canceling the job, retrying the job, or stopping the queue depending on the state of the
+The print file was not successfully transmitted to the device or remote server.
+The scheduler will respond to this by canceling the job, retrying the job, or stopping the queue depending on the state of the
<i>printer-error-policy</i>
attribute.
<dt><b>CUPS_BACKEND_AUTH_REQUIRED</b>
-<dd style="margin-left: 5.0em">The print file was not successfully transmitted because valid authentication information is required. The scheduler will respond to this by holding the job and adding the 'cups-held-for-authentication' keyword to the "job-reasons" Job Description attribute.
+<dd style="margin-left: 5.0em">The print file was not successfully transmitted because valid authentication information is required.
+The scheduler will respond to this by holding the job and adding the 'cups-held-for-authentication' keyword to the "job-reasons" Job Description attribute.
<dt><b>CUPS_BACKEND_HOLD</b>
-<dd style="margin-left: 5.0em">The print file was not successfully transmitted because it cannot be printed at this time. The scheduler will respond to this by holding the job.
+<dd style="margin-left: 5.0em">The print file was not successfully transmitted because it cannot be printed at this time.
+The scheduler will respond to this by holding the job.
<dt><b>CUPS_BACKEND_STOP</b>
-<dd style="margin-left: 5.0em">The print file was not successfully transmitted because it cannot be printed at this time. The scheduler will respond to this by stopping the queue.
+<dd style="margin-left: 5.0em">The print file was not successfully transmitted because it cannot be printed at this time.
+The scheduler will respond to this by stopping the queue.
<dt><b>CUPS_BACKEND_CANCEL</b>
-<dd style="margin-left: 5.0em">The print file was not successfully transmitted because one or more attributes are not supported or the job was canceled at the printer. The scheduler will respond to this by canceling the job.
+<dd style="margin-left: 5.0em">The print file was not successfully transmitted because one or more attributes are not supported or the job was canceled at the printer.
+The scheduler will respond to this by canceling the job.
<dt><b>CUPS_BACKEND_RETRY</b>
-<dd style="margin-left: 5.0em">The print file was not successfully transmitted because of a temporary issue. The scheduler will retry the job at a future time - other jobs may print before this one.
+<dd style="margin-left: 5.0em">The print file was not successfully transmitted because of a temporary issue.
+The scheduler will retry the job at a future time - other jobs may print before this one.
<dt><b>CUPS_BACKEND_RETRY_CURRENT</b>
-<dd style="margin-left: 5.0em">The print file was not successfully transmitted because of a temporary issue. The scheduler will retry the job immediately without allowing intervening jobs.
+<dd style="margin-left: 5.0em">The print file was not successfully transmitted because of a temporary issue.
+The scheduler will retry the job immediately without allowing intervening jobs.
</dl>
<p>All other exit code values are reserved.
<h2 class="title"><a name="ENVIRONMENT">Environment</a></h2>
In addition to the environment variables listed in
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1)</a>
+<b>cups</b>(1)
and
-<a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7),</a>
+<b>filter</b>(7),
CUPS backends can expect the following environment variable:
<dl class="man">
<dt><b>DEVICE_URI</b>
<h2 class="title"><a name="FILES">Files</a></h2>
<i>/etc/cups/cups-files.conf</i>
<h2 class="title"><a name="NOTES">Notes</a></h2>
-CUPS backends are not generally designed to be run directly by the user. Aside from the device URI issue (
+CUPS backends are not generally designed to be run directly by the user.
+Aside from the device URI issue (
<i>argv[0]</i>
and
<b>DEVICE_URI</b>
-environment variable contain the device URI), CUPS backends also expect specific environment variables and file descriptors, and typically run in a user session that (on macOS) has additional restrictions that affect how it runs. Backends can also be installed with restricted permissions (0500 or 0700) that tell the scheduler to run them as the "root" user instead of an unprivileged user (typically "lp") on the system.
-<p>Unless you are a developer and know what you are doing, please do not run backends directly. Instead, use the
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1)</a>
+environment variable contain the device URI), CUPS backends also expect specific environment variables and file descriptors, and typically run in a user session that (on macOS) has additional restrictions that affect how it runs.
+Backends can also be installed with restricted permissions (0500 or 0700) that tell the scheduler to run them as the "root" user instead of an unprivileged user (typically "lp") on the system.
+<p>Unless you are a developer and know what you are doing, please do not run backends directly.
+Instead, use the
+<b>lp</b>(1)
or
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1)</a>
+<b>lpr</b>(1)
programs to send print jobs or
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8)</a>
-to query for available printers using the backend. The one exception is the SNMP backend - see
-<a href="man-cups-snmp.html?TOPIC=Man+Pages"><b>cups-snmp</b>(8)</a>
+<b>lpinfo</b>(8)
+to query for available printers using the backend.
+The one exception is the SNMP backend - see
+<b>cups-snmp</b>(8)
for more information.
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
<i>cups</i>(1),
<i>cups-files.conf</i>(5),
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
</pre>
<h2 class="title"><a name="NOTES">Notes</a></h2>
Administrators wishing to prevent unauthorized cancellation of jobs via the <i>-u</i> option should require authentication for Cancel-Jobs operations in
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5).</a>
+<b>cupsd.conf</b>(5).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpmove.html?TOPIC=Man+Pages"><b>lpmove</b>(8),</a>
-<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
+<b>cupsd.conf</b>(5),
+<b>lp</b>(1),
+<b>lpmove</b>(8),
+<b>lpstat</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<h2 class="title"><a name="NAME">Name</a></h2>
classes.conf - class configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <b>classes.conf</b> file defines the local printer classes that are available. It is normally located in the <i>/etc/cups</i> directory and is maintained by the
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8)</a>
-program. This file is not intended to be edited or managed manually.
+The <b>classes.conf</b> file defines the local printer classes that are available.
+It is normally located in the <i>/etc/cups</i> directory and is maintained by the
+<b>cupsd</b>(8)
+program.
+This file is not intended to be edited or managed manually.
<h2 class="title"><a name="NOTES">Notes</a></h2>
The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
-<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
-<a href="man-subscriptions.conf.html?TOPIC=Man+Pages"><b>subscriptions.conf</b>(5),</a>
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
+<b>mime.convs</b>(5),
+<b>mime.types</b>(5),
+<b>printers.conf</b>(5),
+<b>subscriptions.conf</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<body>
<h1 class="title">client.conf(5)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
-client.conf - client configuration file for cups
+client.conf - client configuration file for cups (deprecated on macos)
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <b>client.conf</b> file configures the CUPS client and is normally located in the <i>/etc/cups</i> and/or <i>~/.cups</i> directories.
Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
</pre>
On Linux and other systems using GNU TLS, the <i>/etc/cups/ssl/site.crl</i> file, if present, provides a list of revoked X.509 certificates and is used when validating certificates.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
+<b>cups</b>(1),
<b>default</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<dd style="margin-left: 5.0em">Reports the default CUPS data directory.
<dt><b>--help</b>
<dd style="margin-left: 5.0em">Reports the program usage message.
-<dt><b>--image</b>
-<dd style="margin-left: 5.0em">When used with <i>--libs</i>, adds the CUPS imaging library to the
-list of libraries.
<dt><b>--ldflags</b>
<dd style="margin-left: 5.0em">Reports the necessary linker options.
<dt><b>--libs</b>
cc `cups-config --cflags --ldflags` -o filter filter.c \
`cups-config --libs`
</pre>
+<h2 class="title"><a name="DEPRECATED_OPTIONS">Deprecated Options</a></h2>
+The following options are deprecated but continue to work for backwards compatibility:
+<dl class="man">
+<dt><b>--image</b>
+<dd style="margin-left: 5.0em">Formerly used to add the CUPS imaging library to the list of libraries.
+</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
+<b>cups</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
cups-files.conf - file and directory configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <b>cups-files.conf</b> file configures the files and directories used by the CUPS scheduler,
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8).</a>
+<b>cupsd</b>(8).
It is normally located in the <i>/etc/cups</i> directory.
<p>Each line in the file can be a configuration directive, a blank line, or a comment.
Configuration directives typically consist of a name and zero or more values separated by whitespace.
Comment lines start with the # character.
<h3><a name="DIRECTIVES">Directives</a></h3>
The following directives are understood by
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8):</a>
+<b>cupsd</b>(8):
<dl class="man">
<dt><a name="AccessLog"></a><b>AccessLog</b>
<dd style="margin-left: 5.0em"><dt><b>AccessLog </b><i>filename</i>
<b>launchctl</b>(8)
command is used instead.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
-<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
-<a href="man-subscriptions.conf.html?TOPIC=Man+Pages"><b>subscriptions.conf</b>(5),</a>
+<b>classes.conf</b>(5),
+<b>cups</b>(1),
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
+<b>mime.convs</b>(5),
+<b>mime.types</b>(5),
+<b>printers.conf</b>(5),
+<b>subscriptions.conf</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<body>
<h1 class="title">cups-lpd(8)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
-cups-lpd - receive print jobs and report printer status to lpd clients
+cups-lpd - receive print jobs and report printer status to lpd clients (deprecated)
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cups-lpd</b>
[
<i>/System/Library/LaunchDaemons/org.cups.cups-lpd.plist</i>
</pre>
<h2 class="title"><a name="NOTES">Notes</a></h2>
+The
+<b>cups-lpd</b>
+program is deprecated and will no longer be supported in a future feature release of CUPS.
<h3><a name="PERFORMANCE">Performance</a></h3>
<b>cups-lpd</b>
performs well with small numbers of clients and printers.
<b>cups-lpd</b>
service using the corresponding control program.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<b>cups</b>(1),
+<b>cupsd</b>(8),
<b>inetconv</b>(1m),
<b>inetd</b>(8),
<b>launchd</b>(8),
CUPS Online Help (<a href="http://localhost:631/help)">http://localhost:631/help)</a>,
RFC 2569
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<body>
<h1 class="title">snmp.conf(5)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
-snmp.conf - snmp configuration file for cups
+snmp.conf - snmp configuration file for cups (deprecated)
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The
<b>snmp.conf</b>
file configures how the standard CUPS network backends (http, https, ipp, ipps, lpd, snmp, and socket) access printer information using SNMPv1 and is normally located in the <i>/etc/cups</i> directory.
Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
<p>The Community and DebugLevel directives are used by all backends. The remainder apply only to the SNMP backend -
-<a href="man-cups-snmp.html?TOPIC=Man+Pages"><b>cups-snmp</b>(8).</a>
+<b>cups-snmp</b>(8).
<h2 class="title"><a name="DIRECTIVES">Directives</a></h2>
The following directives are understood by the CUPS network backends:
<dl class="man">
network for printers.
The default is 120 seconds (2 minutes).
</dl>
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+CUPS backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups-snmp.html?TOPIC=Man+Pages"><b>cups-snmp</b>(8),</a>
+<b>cups-snmp</b>(8),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<body>
<h1 class="title">cups-snmp(8)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
-snmp - cups snmp backend
+snmp - cups snmp backend (deprecated)
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>/usr/lib/cups/backend/snmp</b>
<i>ip-address-or-hostname</i>
<p>In the first form, the SNMP backend is run directly by the user to look up the device URI and other information when you have an IP address or hostname.
This can be used for programs that need to configure print queues where the user has supplied an address but nothing else.
<p>In the second form, the SNMP backend is run indirectly using the
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8)</a>
+<b>lpinfo</b>(8)
command.
The output provides all printers detected via SNMP on the configured
broadcast addresses.
<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
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.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-backend.html?TOPIC=Man+Pages"><b>backend</b>(7),</a>
-<a href="man-cups-snmp.conf.html?TOPIC=Man+Pages"><b>cups-snmp.conf</b>(5),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8),</a>
+<b>backend</b>(7),
+<b>cups-snmp.conf</b>(5),
+<b>cupsd</b>(8),
+<b>lpinfo</b>(8),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<p>After the printer is added you will be asked to set the default printer options (paper size, output mode, etc.) for the printer. Make any changes as needed and then click/press on the Set Default Options button to save them. Some printers also support auto-configuration - click/press on the Query Printer for Default Options button to update the options automatically.
<p>Once you have added the printer, you can print to it from any application. You can also choose Print Test Page from the maintenance menu to print a simple test page and verify that everything is working properly.
<p>You can also use the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+<b>lpadmin</b>(8)
and
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8)</a>
+<b>lpinfo</b>(8)
commands to add printers to
<b>CUPS</b>.
Additionally, your operating system may include graphical user interfaces or automatically create printer queues when you connect a printer to your computer.
<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
<b>CUPS</b>
conforms to the Internet Printing Protocol version 2.1 and implements the Berkeley and System V UNIX print commands.
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+CUPS printer drivers, backends, and PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-client.conf.html?TOPIC=Man+Pages"><b>client.conf</b>(7),</a>
-<a href="man-cupsctl.html?TOPIC=Man+Pages"><b>cupsctl</b>(8),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8),</a>
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
-<a href="man-lpq.html?TOPIC=Man+Pages"><b>lpq</b>(1),</a>
-<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
+<b>cancel</b>(1),
+<b>client.conf</b>(7),
+<b>cupsctl</b>(8),
+<b>cupsd</b>(8),
+<b>lp</b>(1),
+<b>lpadmin</b>(8),
+<b>lpinfo</b>(8),
+<b>lpoptions</b>(1),
+<b>lpr</b>(1),
+<b>lprm</b>(1),
+<b>lpq</b>(1),
+<b>lpstat</b>(1),
CUPS Online Help (<a href="http://localhost:631/help)">http://localhost:631/help)</a>,
CUPS Web Site (<a href="http://www.CUPS.org)">http://www.CUPS.org)</a>,
PWG Internet Printing Protocol Workgroup (<a href="http://www.pwg.org/ipp">http://www.pwg.org/ipp</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
Also, printer and class names are <i>not</i> case-sensitive.
<p>Finally, the CUPS versions may ask the user for an access password depending on the printing system configuration.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-cupsenable.html?TOPIC=Man+Pages"><b>cupsenable</b>(8),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
+<b>cancel</b>(1),
+<b>cupsenable</b>(8),
+<b>lp</b>(1),
+<b>lpadmin</b>(8),
+<b>lpstat</b>(1),
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<h2 class="title"><a name="KNOWN_ISSUES">Known Issues</a></h2>
You cannot set the Listen or Port directives using <b>cupsctl</b>.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<b>cupsd.conf</b>(5),
+<b>cupsd</b>(8),
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<body>
<h1 class="title">cupsd-helper(8)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
-cupsd-helper - cupsd helper programs
+cupsd-helper - cupsd helper programs (deprecated)
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cups-deviced</b>
<i>request-id</i>
<i>argvN</i>
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <b>cupsd-helper</b> programs perform long-running operations on behalf of the scheduler,
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8).</a>
+<b>cupsd</b>(8).
The <b>cups-deviced</b> helper program runs each CUPS
-<a href="man-backend.html?TOPIC=Man+Pages"><b>backend</b>(7)</a>
+<b>backend</b>(7)
with no arguments in order to discover the available printers.
<p>The <b>cups-driverd</b> helper program lists all available printer drivers, a subset of "matching" printer drivers, or a copy of a specific driver PPD file.
<p>The <b>cups-exec</b> helper program runs backends, filters, and other programs. On macOS these programs are run in a secure sandbox.
<b>tar</b>(1)
archives to further reduce their size.
<p>Driver information files must conform to the format defined in
-<a href="man-ppdcfile.html?TOPIC=Man+Pages"><b>ppdcfile</b>(5).</a>
+<b>ppdcfile</b>(5).
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+CUPS printer drivers, backends, and PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-backend.html?TOPIC=Man+Pages"><b>backend</b>(7),</a>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7),</a>
-<a href="man-ppdcfile.html?TOPIC=Man+Pages"><b>ppdcfile</b>(5),</a>
+<b>backend</b>(7),
+<b>cups</b>(1),
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
+<b>filter</b>(7),
+<b>ppdcfile</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<h2 class="title"><a name="NAME">Name</a></h2>
cupsd-logs - cupsd log files (access_log, error_log, and page_log)
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8)</a>
+<b>cupsd</b>(8)
normally maintains three log files: <i>access_log</i> to track requests that are submitted to the scheduler, <i>error_log</i> to track progress and errors, and <i>page_log</i> to track pages that are printed.
Configuration directives in
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5)</a>
+<b>cupsd.conf</b>(5)
and
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
+<b>cups-files.conf</b>(5)
control what information is logged and where it is stored.
<h3><a name="ACCESS_LOG_FILE_FORMAT">Access Log File Format</a></h3>
The <i>access_log</i> file lists each HTTP resource that is accessed by a web browser or client.
<p>The <i>ipp-status</i> field contains either "-" for non-IPP requests or the IPP status code name for POST requests containing an IPP response.
<h3><a name="ERROR_LOG_FILE_FORMAT">Error Log File Format</a></h3>
The <i>error_log</i> file lists messages from the scheduler - errors, warnings, etc. The LogLevel directive in the
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5)</a>
+<b>cupsd.conf</b>(5)
file controls which messages are logged:
<pre class="man">
</pre>
The PageLogFormat directive in the
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5)</a>
+<b>cupsd.conf</b>(5)
file can be used to change this information.
<p>The <i>printer</i> field contains the name of the printer that printed the page.
If you send a job to a printer class, this field will contain the name of the printer that was assigned the job.
<p>The <i>media</i> field contains a copy of the media or media-col/media-size attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.
<p>The <i>sides</i> field contains a copy of the sides attribute provided with the IPP Create-Job or Print-Job requests or "-" if none was provided.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5),</a>
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
+<b>cups-files.conf</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
The
<i>cupsd.conf</i>
file configures the CUPS scheduler,
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8).</a>
+<b>cupsd</b>(8).
It is normally located in the
<i>/etc/cups</i>
directory.
Comment lines start with the # character.
<h3><a name="TOP_LEVEL_DIRECTIVES">Top-level Directives</a></h3>
The following top-level directives are understood by
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8):</a>
+<b>cupsd</b>(8):
<dl class="man">
<dt><a name="AccessLogLevel"></a><b>AccessLogLevel config</b>
<dd style="margin-left: 5.0em"><dt><b>AccessLogLevel actions</b>
<dd style="margin-left: 5.0em"><dt><b>HostNameLookups Double</b>
<dd style="margin-left: 5.0em">Specifies whether to do reverse lookups on connecting clients.
The "Double" setting causes
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8)</a>
+<b>cupsd</b>(8)
to verify that the hostname resolved from the address matches one of the addresses returned for that hostname.
Double lookups also prevent clients with unregistered addresses from connecting to your server.
The default is "Off" to avoid the potential server performance problems with hostname lookups.
<dd style="margin-left: 5.0em">Specifies the length of time to wait before shutting down due to inactivity.
The default is "60" seconds.
Note: Only applicable when
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8)</a>
+<b>cupsd</b>(8)
is run on-demand (e.g., with <b>-l</b>).
<dt><a name="JobKillDelay"></a><b>JobKillDelay </b><i>seconds</i>
<dd style="margin-left: 5.0em">Specifies the number of seconds to wait before killing the filters and backend associated with a canceled or held job.
</dl>
<h3><a name="HTTP_METHOD_NAMES">Http Method Names</a></h3>
The following HTTP methods are supported by
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8):</a>
+<b>cupsd</b>(8):
<dl class="man">
<dt>GET
<dd style="margin-left: 5.0em">Used by a client to download icons and other printer resources and to access the CUPS web interface.
</dl>
<h3><a name="IPP_OPERATION_NAMES">Ipp Operation Names</a></h3>
The following IPP operations are supported by
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8):</a>
+<b>cupsd</b>(8):
<dl class="man">
<dt>CUPS-Accept-Jobs
<dd style="margin-left: 5.0em">Allows a printer to accept new jobs.
</dl>
<h3><a name="LOCATION_PATHS">Location Paths</a></h3>
The following paths are commonly used when configuring
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8):</a>
+<b>cupsd</b>(8):
<dl class="man">
<dt>/
<dd style="margin-left: 5.0em">The path for all get operations (get-printers, get-jobs, etc.)
<dt><b>Require user {</b><i>user-name</i>|<b>@</b><i>group-name</i>} ...
<dd style="margin-left: 5.0em">Specifies that an authenticated user must match one of the named users or be a member of one of the named groups.
The group name "@SYSTEM" corresponds to the list of groups defined by the SystemGroup directive in the
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
+<b>cups-files.conf</b>(5)
file.
The group name "@OWNER" corresponds to the owner of the resource, for example the person that submitted a print job.
Note: The 'root' user is not special and must be granted privileges like any other user account.
"@ACL" maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values.
"@OWNER" maps to the job's owner.
"@SYSTEM" maps to the groups listed for the SystemGroup directive in the
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
+<b>cups-files.conf</b>(5)
file.
<dt><b>JobPrivateValues all</b>
<dd style="margin-left: 5.0em"><dt><b>JobPrivateValues default</b>
"@ACL" maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values.
"@OWNER" maps to the job's owner.
"@SYSTEM" maps to the groups listed for the SystemGroup directive in the
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
+<b>cups-files.conf</b>(5)
file.
<dt><b>SubscriptionPrivateValues all</b>
<dd style="margin-left: 5.0em"><dt><b>SubscriptionPrivateValues default</b>
</dl>
<h2 class="title"><a name="NOTES">Notes</a></h2>
File, directory, and user configuration directives that used to be allowed in the <b>cupsd.conf</b> file are now stored in the
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5)</a>
+<b>cups-files.conf</b>(5)
file instead in order to prevent certain types of privilege escalation attacks.
<p>The scheduler MUST be restarted manually after making changes to the <b>cupsd.conf</b> file.
On Linux this is typically done using the
</Location>
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a>
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
-<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
-<a href="man-subscriptions.conf.html?TOPIC=Man+Pages"><b>subscriptions.conf</b>(5),</a>
+<b>classes.conf</b>(5),
+<b>cups-files.conf</b>(5),
+<b>cupsd</b>(8),
+<b>mime.convs</b>(5),
+<b>mime.types</b>(5),
+<b>printers.conf</b>(5),
+<b>subscriptions.conf</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-backend.html?TOPIC=Man+Pages"><b>backend</b>(7),</a>
-<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5),</a>
-<a href="man-cups-lpd.html?TOPIC=Man+Pages"><b>cups-lpd</b>(8),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-cupsd-helper.html?TOPIC=Man+Pages"><b>cupsd-helper</b>(8),</a>
-<a href="man-cupsd-logs.html?TOPIC=Man+Pages"><b>cupsd-logs</b>(8),</a>
-<a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7),</a>
+<b>backend</b>(7),
+<b>classes.conf</b>(5),
+<b>cups</b>(1),
+<b>cups-files.conf</b>(5),
+<b>cups-lpd</b>(8),
+<b>cupsd.conf</b>(5),
+<b>cupsd-helper</b>(8),
+<b>cupsd-logs</b>(8),
+<b>filter</b>(7),
<b>launchd</b>(8),
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
-<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
+<b>mime.convs</b>(5),
+<b>mime.types</b>(5),
+<b>printers.conf</b>(5),
<b>systemd</b>(8),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<p>The CUPS versions of <b>disable</b> and <b>enable</b> may ask the user for an access password depending on the printing system configuration.
This differs from the System V versions which require the root user to execute these commands.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsaccept.html?TOPIC=Man+Pages"><b>cupsaccept</b>(8),</a>
+<b>cupsaccept</b>(8),
<b>cupsreject</b>(8),
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
+<b>cancel</b>(1),
+<b>lp</b>(1),
+<b>lpadmin</b>(8),
+<b>lpstat</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<body>
<h1 class="title">cupsfilter(8)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
-cupsfilter - convert a file to another format using cups filters
+cupsfilter - convert a file to another format using cups filters (deprecated)
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>cupsfilter</b>
[
returns a non-zero exit status on any error.
<h2 class="title"><a name="ENVIRONMENT">Environment</a></h2>
All of the standard
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1)</a>
+<b>cups</b>(1)
environment variables affect the operation of
<b>cupsfilter</b>.
<h2 class="title"><a name="FILES">Files</a></h2>
/usr/share/cups/mime/*.convs
/usr/share/cups/mime/*.types
<h2 class="title"><a name="NOTES">Notes</a></h2>
-Unlike when printing, filters run using the
+CUPS printer drivers, filters, and backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
+<p>Unlike when printing, filters run using the
<b>cupsfilter</b>
command use the current user and security session. This may result in different output or unexpected behavior.
<h2 class="title"><a name="EXAMPLE">Example</a></h2>
cupsfilter -m application/pdf -d myprinter -j 42 >preview.pdf
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
+<b>cups</b>(1),
+<b>cupsd.conf</b>(5),
<b>filter(7),</b>
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(7),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(7),</a>
+<b>mime.convs</b>(7),
+<b>mime.types</b>(7),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
find . -name \*.ppd \! -exec cupstestppd -q '{}' \; \
-exec cupstestppd -v '{}' \;
</pre>
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
+<b>lpadmin</b>(8),
CUPS Online Help (<a href="http://localhost:631/help)">http://localhost:631/help)</a>,
Adobe PostScript Printer Description File Format Specification, Version 4.3.
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
While the filter interface is compatible with System V interface scripts, CUPS does not support System V interface scripts.
<h2 class="title"><a name="NOTES">Notes</a></h2>
-CUPS filters are not meant to be run directly by the user.
+CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
+<p>CUPS filters are not meant to be run directly by the user.
Aside from the legacy System V interface issues (<i>argv[0]</i> is the printer name), CUPS filters also expect specific environment variables and file descriptors, and typically run in a user session that (on macOS) has additional restrictions that affect how it runs.
Unless you are a developer and know what you are doing, please do not run filters directly.
Instead, use the
-<a href="man-cupsfilter.html?TOPIC=Man+Pages"><b>cupsfilter</b>(8)</a>
+<b>cupsfilter</b>(8)
program to use the appropriate filters to do the conversions you need.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-backend.html?TOPIC=Man+Pages"><b>backend</b>(7),</a>
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1),</a>
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-cupsfilter.html?TOPIC=Man+Pages"><b>cupsfilter</b>(8),</a>
+<b>backend</b>(7),
+<b>cups</b>(1),
+<b>cups-files.conf</b>(5),
+<b>cupsd</b>(8),
+<b>cupsfilter</b>(8),
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
and
<b>ippeveps</b>
are print commands for
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(1).</a>
+<b>ippeveprinter</b>(1).
As with all print commands, these commands read either the filename specified on the command-line or from the standard input.
Output is sent to the standard output.
Status and progress messages are sent to the standard error.
<b>ippeveprinter</b>
program.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ippeveprinter.html?TOPIC=Man+Pages"><b>ippeveprinter</b>(8)</a>
+<b>ippeveprinter</b>(8)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
Copyright © 2019 by Apple Inc.
<b>ippeveprinter</b>
looks for the command in the "ippeveprinter" subdirectory of the CUPS binary directory, typically /usr/lib/cups/ippeveprinter or /usr/libexec/cups/ippeveprinter.
The
-<a href="man-cups-config.html?TOPIC=Man+Pages"><b>cups-config</b>(1)</a>
+<b>cups-config</b>(1)
command can be used to discover the correct binary directory ("cups-config --serverbin").
In addition, the CUPS_SERVERBIN environment variable can be used to override the default location of this directory - see the
-<a href="man-cups.html?TOPIC=Man+Pages"><b>cups</b>(1)</a>
+<b>cups</b>(1)
man page for more details.
<dt><b>-d </b><i>spool-directory</i>
<dd style="margin-left: 5.0em">Specifies the directory that will hold the print files.
-f onepage-letter.ps '{}' print-job.test \;
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(1)</a>
+<b>ipptool</b>(1)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2013-2018 by Apple Inc.
+Copyright © 2013-2019 by Apple Inc.
</body>
</html>
The
<i>testfile</i>
format is described in
-<a href="man-ipptoolfile.html?TOPIC=Man+Pages"><b>ipptoolfile</b>(5).</a>
+<b>ipptoolfile</b>(5).
<h2 class="title"><a name="OPTIONS">Options</a></h2>
The following options are recognized by
<b>ipptool:</b>
ipp://localhost/printers/myprinter create-printer-subscription.test
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ipptoolfile.html?TOPIC=Man+Pages"><b>ipptoolfile</b>(5),</a>
+<b>ipptoolfile</b>(5),
IANA IPP Registry (<a href="http://www.iana.org/assignments/ipp\-registrations)">http://www.iana.org/assignments/ipp\-registrations)</a>,
PWG Internet Printing Protocol Workgroup (<a href="http://www.pwg.org/ipp">http://www.pwg.org/ipp</a>)
RFC 8011 (<a href="http://tools.ietf.org/html/rfc8011)">http://tools.ietf.org/html/rfc8011)</a>,
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
ipptoolfile - ipptool file format
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(1)</a>
+<b>ipptool</b>(1)
program accepts free-form plain text files that describe one or more IPP requests.
Comments start with the "#" character and continue to the end of the line.
Each request is enclosed by curly braces, for example:
<dd style="margin-left: 5.0em">Defines a test.
<dt><b>DEFINE </b><i>variable-name value</i>
<dd style="margin-left: 5.0em">Defines the named variable to the given value. This is equivalent to specifying <i>-d variable-name=value</i> on the
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
command-line.
<dt><b>DEFINE-DEFAULT </b><i>variable-name value</i>
<dd style="margin-left: 5.0em">Defines the named variable to the given value if it does not already have a value.
<dt><b>IGNORE-ERRORS yes</b>
<dd style="margin-left: 5.0em"><dt><b>IGNORE-ERRORS no</b>
<dd style="margin-left: 5.0em">Specifies whether, by default,
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
will ignore errors and continue with subsequent tests.
<dt><b>INCLUDE "</b><i>filename</i><b>"</b>
<dd style="margin-left: 5.0em"><dt><b>INCLUDE <</b><i>filename</i><b>></b>
<dd style="margin-left: 5.0em">Includes another test file. The first form includes a file relative to the current test file, while the second form includes a file from the
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
include directory.
<dt><b>INCLUDE-IF-DEFINED </b><i>name </i><b>"</b><i>filename</i><b>"</b>
<dd style="margin-left: 5.0em"><dt><b>INCLUDE-IF-DEFINED </b><i>name </i><b><</b><i>filename</i><b>></b>
<dd style="margin-left: 5.0em">Includes another test file if the named variable is defined. The first form includes a file relative to the current test file, while the second form includes a file from the
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
include directory.
<dt><b>INCLUDE-IF-NOT-DEFINED </b><i>name </i><b>"</b><i>filename</i><b>"</b>
<dd style="margin-left: 5.0em"><dt><b>INCLUDE-IF-NOT-DEFINED </b><i>name </i><b><</b><i>filename</i><b>></b>
<dd style="margin-left: 5.0em">Includes another test file if the named variable is not defined. The first form includes a file relative to the current test file, while the second form includes a file from the
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
include directory.
<dt><b>SKIP-IF-DEFINED </b><i>variable-name</i>
<dd style="margin-left: 5.0em"><dt><b>SKIP-IF-NOT-DEFINED </b><i>variable-name</i>
<dd style="margin-left: 5.0em">Specifies that tests will, by default, use "Transfer-Encoding: chunked" for requests with attached files and "Content-Length:" for requests without attached files.
<dt><b>TRANSFER chunked</b>
<dd style="margin-left: 5.0em">Specifies that tests will, by default, use the HTTP/1.1 "Transfer-Encoding: chunked" header. This is the default and is equivalent to specifying <i>-c</i> on the
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
command-line. Support for chunked requests is required for conformance with all versions of IPP.
<dt><b>TRANSFER length</b>
<dd style="margin-left: 5.0em">Specifies that tests will, by default, use the HTTP/1.0 "Content-Length:" header. This is equivalent to specifying <i>-l</i> on the
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
command-line. Support for content length requests is required for conformance with all versions of IPP.
<dt><b>VERSION 1.0</b>
<dd style="margin-left: 5.0em"><dt><b>VERSION 1.1</b>
<dt><b>IGNORE-ERRORS yes</b>
<dd style="margin-left: 5.0em"><dt><b>IGNORE-ERRORS no</b>
<dd style="margin-left: 5.0em">Specifies whether
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
will ignore errors and continue with subsequent tests.
<dt><b>NAME "</b><i>literal string</i><b>"</b>
<dd style="margin-left: 5.0em">Specifies the human-readable name of the test.
<dd style="margin-left: 5.0em">Specifies the request-id value to use in the request, either an integer or the word "random" to use a randomly generated value (the default).
<dt><b>RESOURCE </b><i>path</i>
<dd style="margin-left: 5.0em">Specifies an alternate resource path that is used for the HTTP POST request. The default is the resource from the URI provided to the
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
program.
<dt><b>SKIP-IF-DEFINED </b><i>variable-name</i>
<dd style="margin-left: 5.0em"><dt><b>SKIP-IF-NOT-DEFINED </b><i>variable-name</i>
<dt><b>SKIP-PREVIOUS-ERROR yes</b>
<dd style="margin-left: 5.0em"><dt><b>SKIP-PREVIOUS-ERROR no</b>
<dd style="margin-left: 5.0em">Specifies whether
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
will skip the current test if the previous test resulted in an error/failure.
<dt><b>STATUS </b><i>status-code </i>[ <i>predicate</i> ]
<dd style="margin-left: 5.0em">Specifies an expected response status-code value. Additional requirements can be added as predicates - see the "STATUS PREDICATES" section for more information on predicates.
</dl>
<h3><a name="OPERATION_CODES">Operation Codes</a></h3>
Operation codes correspond to the hexadecimal numbers (0xHHHH) and names from RFC 8011 and other IPP extension specifications. Here is a complete list of names supported by
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8):</a>
+<b>ipptool</b>(8):
<pre class="man">
Activate-Printer
</pre>
<h3><a name="STATUS_CODES">Status Codes</a></h3>
Status codes correspond to the hexadecimal numbers (0xHHHH) and names from RFC 8011 and other IPP extension specifications. Here is a complete list of the names supported by
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8):</a>
+<b>ipptool</b>(8):
<pre class="man">
client-error-account-authorization-failed
</pre>
<h3><a name="VARIABLES">Variables</a></h3>
The
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
program maintains a list of variables that can be used in any literal string or attribute value by specifying "<i>$variable-name</i>". Aside from variables defined using the <i>-d</i> option or <b>DEFINE</b> directive, the following pre-defined variables are available:
<dl class="man">
<dt><b>$$</b>
<dd style="margin-left: 5.0em">Inserts the value of the named environment variable, or an empty string if the environment variable is not defined.
<dt><b>$filename</b>
<dd style="margin-left: 5.0em">Inserts the filename provided to
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
with the <i>-f</i> option.
<dt><b>$filetype</b>
<dd style="margin-left: 5.0em">Inserts the MIME media type for the filename provided to
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8)</a>
+<b>ipptool</b>(8)
with the <i>-f</i> option.
<dt><b>$hostname</b>
<dd style="margin-left: 5.0em">Inserts the hostname from the URI provided to
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8).</a>
+<b>ipptool</b>(8).
<dt><b>$job-id</b>
<dd style="margin-left: 5.0em">Inserts the last "job-id" attribute value returned in a test response or 0 if no "job-id" attribute has been seen.
<dt><b>$job-uri</b>
<dd style="margin-left: 5.0em">Inserts the last "notify-subscription-id" attribute value returned in a test response or 0 if no "notify-subscription-id" attribute has been seen.
<dt><b>$port</b>
<dd style="margin-left: 5.0em">Inserts the port number from the URI provided to
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8).</a>
+<b>ipptool</b>(8).
<dt><b>$resource</b>
<dd style="margin-left: 5.0em">Inserts the resource path from the URI provided to
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8).</a>
+<b>ipptool</b>(8).
<dt><b>$scheme</b>
<dd style="margin-left: 5.0em">Inserts the scheme from the URI provided to
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8).</a>
+<b>ipptool</b>(8).
<dt><b>$uri</b>
<dd style="margin-left: 5.0em">Inserts the URI provided to
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8).</a>
+<b>ipptool</b>(8).
<dt><b>$uriuser</b>
<dd style="margin-left: 5.0em">Inserts the username from the URI provided to
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(8),</a>
+<b>ipptool</b>(8),
if any.
<dt><b>$user</b>
<dd style="margin-left: 5.0em">Inserts the current user's login name.
</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ipptool.html?TOPIC=Man+Pages"><b>ipptool</b>(1),</a>
+<b>ipptool</b>(1),
IANA IPP Registry (<a href="http://www.iana.org/assignments/ipp-registrations)">http://www.iana.org/assignments/ipp-registrations)</a>,
PWG Internet Printing Protocol Workgroup (<a href="http://www.pwg.org/ipp)">http://www.pwg.org/ipp)</a>,
RFC 8011 (<a href="http://tools.ietf.org/html/rfc8011">http://tools.ietf.org/html/rfc8011</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<h3><a name="THE_DEFAULT_DESTINATION">The Default Destination</a></h3>
CUPS provides many ways to set the default destination. The <b>LPDEST</b> and <b>PRINTER</b> environment variables are consulted first.
If neither are set, the current default set using the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
command is used, followed by the default set using the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+<b>lpadmin</b>(8)
command.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
The following options are recognized by <i>lp</i>:
</dl>
<h3><a name="COMMON_JOB_OPTIONS">Common Job Options</a></h3>
Aside from the printer-specific options reported by the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
command, the following generic options are available:
<dl class="man">
<dt><b>-o job-sheets=</b><i>name</i>
lp -d bar -o number-up=2 filename
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a>
-<a href="man-lpq.html?TOPIC=Man+Pages"><b>lpq</b>(1),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
-<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
+<b>cancel</b>(1),
+<b>lpadmin</b>(8),
+<b>lpoptions</b>(1),
+<b>lpq</b>(1),
+<b>lpr</b>(1),
+<b>lprm</b>(1),
+<b>lpstat</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<p>When specified before the <i>-d</i>, <i>-p</i>, or <i>-x</i> options, the <i>-E</i> option forces encryption when connecting to the server.
<p>The first form of the command (<i>-d</i>) sets the default printer or class to <i>destination</i>.
Subsequent print jobs submitted via the
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1)</a>
+<b>lp</b>(1)
or
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1)</a>
+<b>lpr</b>(1)
commands will use this destination unless the user specifies otherwise with the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
command.
<p>The second form of the command (<i>-p</i>) configures the named printer or class. The additional options are described below.
<p>The third form of the command (<i>-x</i>) deletes the printer or class <i>destination</i>.
<dt><b>-m </b><i>model</i>
<dd style="margin-left: 5.0em">Sets a standard PPD file for the printer from the <i>model</i> directory or using one of the driver interfaces.
Use the <i>-m</i> option with the
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8)</a>
+<b>lpinfo</b>(8)
command to get a list of supported models.
The model "raw" clears any existing PPD file and the model "everywhere" queries the printer referred to by the specified IPP <i>device-uri</i>.
Note: Models other than "everywhere" are deprecated and will not be supported in a future version of CUPS.
<dt><b>-o </b><i>name</i><b>=</b><i>value</i>
<dd style="margin-left: 5.0em">Sets a PPD option for the printer.
PPD options can be listed using the <i>-l</i> option with the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
command.
<dt><b>-o </b><i>name</i><b>-default=</b><i>value</i>
<dd style="margin-left: 5.0em">Sets a default server-side option for the destination.
<dt><b>-v "</b><i>device-uri</i><b>"</b>
<dd style="margin-left: 5.0em">Sets the <i>device-uri</i> attribute of the printer queue.
Use the <i>-v</i> option with the
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8)</a>
+<b>lpinfo</b>(8)
command to get a list of supported device URIs and schemes.
<dt><b>-D "</b><i>info</i><b>"</b>
<dd style="margin-left: 5.0em">Provides a textual description of the destination.
<dt><b>-E</b>
<dd style="margin-left: 5.0em">When specified before the <b>-d</b>, <b>-p</b>, or <b>-x</b> options, forces the use of TLS encryption on the connection to the scheduler.
Otherwise, enables the destination and accepts jobs; this is the same as running the
-<a href="man-cupsaccept.html?TOPIC=Man+Pages"><b>cupsaccept</b>(8)</a>
+<b>cupsaccept</b>(8)
and
-<a href="man-cupsenable.html?TOPIC=Man+Pages"><b>cupsenable</b>(8)</a>
+<b>cupsenable</b>(8)
programs on the destination.
<dt><b>-L "</b><i>location</i><b>"</b>
<dd style="margin-left: 5.0em">Provides a textual location of the destination.
<p>Finally, the CUPS version of <b>lpadmin</b> may ask the user for an access password depending on the printing system configuration.
This differs from the System V version which requires the root user to execute this command.
<h2 class="title"><a name="NOTES">Notes</a></h2>
-The CUPS version of <b>lpadmin</b> does not support all of the System V or Solaris printing system configuration options.
+CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
+<p>The CUPS version of <b>lpadmin</b> does not support all of the System V or Solaris printing system configuration options.
<p>Interface scripts are not supported for security reasons.
<p>The double meaning of the <b>-E</b> option is an unfortunate historical oddity.
<p>The <b>lpadmin</b> command communicates with the scheduler (<b>cupsd</b>) to make changes to the printing system configuration.
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsaccept.html?TOPIC=Man+Pages"><b>cupsaccept</b>(8),</a>
-<a href="man-cupsenable.html?TOPIC=Man+Pages"><b>cupsenable</b>(8),</a>
-<a href="man-lpinfo.html?TOPIC=Man+Pages"><b>lpinfo</b>(8),</a>
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a>
+<b>cupsaccept</b>(8),
+<b>cupsenable</b>(8),
+<b>lpinfo</b>(8),
+<b>lpoptions</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<body>
<h1 class="title">lpc(8)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
-lpc - line printer control program
+lpc - line printer control program (deprecated)
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>lpc</b>
[
<dd style="margin-left: 5.0em">Displays the status of one or more printer or class queues.
</dl>
<h2 class="title"><a name="NOTES">Notes</a></h2>
-Since <b>lpc</b> is geared towards the Berkeley printing system, it is impossible to use <b>lpc</b> to configure printer or class queues provided by CUPS.
+This program is deprecated and will be removed in a future feature release of CUPS.
+<p>Since <b>lpc</b> is geared towards the Berkeley printing system, it is impossible to use <b>lpc</b> to configure printer or class queues provided by CUPS.
To configure printer or class queues you must use the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+<b>lpadmin</b>(8)
command or another CUPS-compatible client with that functionality.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-cupsaccept.html?TOPIC=Man+Pages"><b>cupsaccept</b>(8),</a>
-<a href="man-cupsenable.html?TOPIC=Man+Pages"><b>cupsenable</b>(8),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
-<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
+<b>cancel</b>(1),
+<b>cupsaccept</b>(8),
+<b>cupsenable</b>(8),
+<b>lp</b>(1),
+<b>lpadmin</b>(8),
+<b>lpr</b>(1),
+<b>lprm</b>(1),
+<b>lpstat</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<body>
<h1 class="title">lpinfo(8)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
-lpinfo - show available devices or drivers
+lpinfo - show available devices or drivers (deprecated)
<h2 class="title"><a name="SYNOPSIS">Synopsis</a></h2>
<b>lpinfo</b>
[
lpinfo --make-and-model "HP LaserJet" -m
</pre>
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
+<b>lpadmin</b>(8),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
lpmove oldprinter newprinter
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
+<b>cancel</b>(1),
+<b>lp</b>(1),
+<b>lpr</b>(1),
+<b>lprm</b>(1),
<br>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
<b>lpoptions</b> displays or sets printer options and defaults.
If no printer is specified using the <i>-p</i> option, the default printer is used as described in
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1).</a>
+<b>lp</b>(1).
<p>If no <i>-l</i>, <i>-o</i>, or <i>-r</i> options are specified, the current options are reported on the standard output.
<p>Options set with the <b>lpoptions</b> command are used by the
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1)</a>
+<b>lp</b>(1)
and
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1)</a>
+<b>lpr</b>(1)
commands when submitting jobs.
<p>When run by the root user, <b>lpoptions</b> gets and sets default options and instances for all users in the <i>/etc/cups/lpoptions</i> file.
Otherwise, the per-user defaults are managed in the <i>~/.cups/lpoptions</i> file.
<dd style="margin-left: 5.0em">Sets the destination and instance, if specified, for any options that follow.
If the named instance does not exist then it is created.
Destinations can only be created using the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+<b>lpadmin</b>(8)
program.
<dt><b>-r </b><i>option</i>
<dd style="margin-left: 5.0em">Removes the specified option from the named destination.
<dd style="margin-left: 5.0em">Removes the options for the named destination and instance, if specified.
If the named instance does not exist then this does nothing.
Destinations can only be removed using the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+<b>lpadmin</b>(8)
command.
</dl>
<h2 class="title"><a name="FILES">Files</a></h2>
<h2 class="title"><a name="CONFORMING_TO">Conforming To</a></h2>
The <b>lpoptions</b> command is unique to CUPS.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
+<b>cancel</b>(1),
+<b>lp</b>(1),
+<b>lpadmin</b>(8),
+<b>lpr</b>(1),
+<b>lprm</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<dd style="margin-left: 5.0em">Requests a more verbose (long) reporting format.
</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
-<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
+<b>cancel</b>(1),
+<b>lp</b>(1),
+<b>lpr</b>(1),
+<b>lprm</b>(1),
+<b>lpstat</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<h3><a name="THE_DEFAULT_DESTINATION">The Default Destination</a></h3>
CUPS provides many ways to set the default destination. The <b>LPDEST</b> and <b>PRINTER</b> environment variables are consulted first.
If neither are set, the current default set using the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
command is used, followed by the default set using the
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8)</a>
+<b>lpadmin</b>(8)
command.
<h2 class="title"><a name="OPTIONS">Options</a></h2>
The following options are recognized by <i>lpr</i>:
</dl>
<h3><a name="COMMON_JOB_OPTIONS">Common Job Options</a></h3>
Aside from the printer-specific options reported by the
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1)</a>
+<b>lpoptions</b>(1)
command, the following generic options are available:
<dl class="man">
<dt><b>-o job-sheets=</b><i>name</i>
lpr -P foo -o number-up=2 filename
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpadmin.html?TOPIC=Man+Pages"><b>lpadmin</b>(8),</a>
-<a href="man-lpoptions.html?TOPIC=Man+Pages"><b>lpoptions</b>(1),</a>
-<a href="man-lpq.html?TOPIC=Man+Pages"><b>lpq</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
-<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
+<b>cancel</b>(1),
+<b>lp</b>(1),
+<b>lpadmin</b>(8),
+<b>lpoptions</b>(1),
+<b>lpq</b>(1),
+<b>lprm</b>(1),
+<b>lpstat</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
lprm -
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpq.html?TOPIC=Man+Pages"><b>lpq</b>(1),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lpstat.html?TOPIC=Man+Pages"><b>lpstat</b>(1),</a>
+<b>cancel</b>(1),
+<b>lp</b>(1),
+<b>lpq</b>(1),
+<b>lpr</b>(1),
+<b>lpstat</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<p>The <i>-h</i>, <i>-e</i>, <i>-E</i>, <i>-U</i>, and <i>-W</i> options are unique to CUPS.
<p>The Solaris <i>-f</i>, <i>-P</i>, and <i>-S</i> options are silently ignored.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cancel.html?TOPIC=Man+Pages"><b>cancel</b>(1),</a>
-<a href="man-lp.html?TOPIC=Man+Pages"><b>lp</b>(1),</a>
-<a href="man-lpq.html?TOPIC=Man+Pages"><b>lpq</b>(1),</a>
-<a href="man-lpr.html?TOPIC=Man+Pages"><b>lpr</b>(1),</a>
-<a href="man-lprm.html?TOPIC=Man+Pages"><b>lprm</b>(1),</a>
+<b>cancel</b>(1),
+<b>lp</b>(1),
+<b>lpq</b>(1),
+<b>lpr</b>(1),
+<b>lprm</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<dd style="margin-left: 5.0em">Specifies a prefix string for the subject line of an email notification.
</dl>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
+<b>cupsd</b>(8),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<body>
<h1 class="title">mime.convs(5)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
-mime.convs - mime type conversion file for cups
+mime.convs - mime type conversion file for cups (deprecated)
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <b>mime.convs</b> file defines the filters that are available for converting files from one format to another.
The standard filters support text, PDF, PostScript, and many types of image files.
application/vnd.cups-postscript application/vnd.cups-raster 50 pstoraster
</pre>
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+CUPS filters are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-cupsfilter.html?TOPIC=Man+Pages"><b>cupsfilter</b>(8),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
+<b>cups-files.conf</b>(5),
+<b>cupsd.conf</b>(5),
+<b>cupsd</b>(8),
+<b>cupsfilter</b>(8),
+<b>mime.types</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
string(4,PwgRaster<00>) priority(150)
</pre>
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cups-files.conf.html?TOPIC=Man+Pages"><b>cups-files.conf</b>(5),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-cupsfilter.html?TOPIC=Man+Pages"><b>cupsfilter</b>(8),</a>
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
+<b>cups-files.conf</b>(5),
+<b>cupsd.conf</b>(5),
+<b>cupsd</b>(8),
+<b>cupsfilter</b>(8),
+<b>mime.convs</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
functions and exit on error.
Notifiers are encouraged to exit after a suitable period of inactivity, however they may exit after reading the first message or stay running until an error is seen.
Notifiers inherit the environment and can use the logging mechanism documented in
-<a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7).</a>
+<b>filter</b>(7).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-filter.html?TOPIC=Man+Pages"><b>filter</b>(7),</a>
+<b>cupsd</b>(8),
+<b>filter</b>(7),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<dd style="margin-left: 5.0em">Specifies the line ending to use - carriage return, carriage return and line feed, or line feed alone.
The default is to use the line feed character alone.
</dl>
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ppdhtml.html?TOPIC=Man+Pages"><b>ppdhtml</b>(1),</a>
-<a href="man-ppdi.html?TOPIC=Man+Pages"><b>ppdi</b>(1),</a>
-<a href="man-ppdmerge.html?TOPIC=Man+Pages"><b>ppdmerge</b>(1),</a>
-<a href="man-ppdpo.html?TOPIC=Man+Pages"><b>ppdpo</b>(1),</a>
-<a href="man-ppdcfile.html?TOPIC=Man+Pages"><b>ppdcfile</b>(5),</a>
+<b>ppdhtml</b>(1),
+<b>ppdi</b>(1),
+<b>ppdmerge</b>(1),
+<b>ppdpo</b>(1),
+<b>ppdcfile</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<body>
<h1 class="title">ppdcfile(5)</h1>
<h2 class="title"><a name="NAME">Name</a></h2>
-ppdcfile - cups ppd compiler source file format
+ppdcfile - cups ppd compiler source file format (deprecated)
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The CUPS PPD compiler reads meta files that contain descriptions of one or more PPD files to be generated by
-<a href="man-ppdc.html?TOPIC=Man+Pages"><b>ppdc</b>(1).</a>
+<b>ppdc</b>(1).
This man page provides a quick reference to the supported keywords and should be used in conjunction with the online help for CUPS.
<p>The source file format is plain ASCII text that can be edited using your favorite text editor. Comments are supported using the C (/* ... */) and C++ (// ...) comment mechanisms.
<p>Printer driver information can be grouped and shared using curly braces ({ ... }); PPD files are written when a close brace or end-of-file is seen and a PCFileName directive has been defined.
<dd style="margin-left: 5.0em"><dt><b>VariablePaperSize </b><i>boolean-value</i>
<dd style="margin-left: 5.0em"><dt><b>Version </b><i>number</i>
<dd style="margin-left: 5.0em"></dl>
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ppdc.html?TOPIC=Man+Pages"><b>ppdc</b>(1),</a>
-<a href="man-ppdhtml.html?TOPIC=Man+Pages"><b>ppdhtml</b>(1),</a>
-<a href="man-ppdi.html?TOPIC=Man+Pages"><b>ppdi</b>(1),</a>
-<a href="man-ppdmerge.html?TOPIC=Man+Pages"><b>ppdmerge</b>(1),</a>
-<a href="man-ppdpo.html?TOPIC=Man+Pages"><b>ppdpo</b>(1),</a>
+<b>ppdc</b>(1),
+<b>ppdhtml</b>(1),
+<b>ppdi</b>(1),
+<b>ppdmerge</b>(1),
+<b>ppdpo</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<dd style="margin-left: 5.0em">Specifies an alternate include directory.
Multiple <i>-I</i> options can be supplied to add additional directories.
</dl>
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ppdc.html?TOPIC=Man+Pages"><b>ppdc</b>(1),</a>
-<a href="man-ppdcfile.html?TOPIC=Man+Pages"><b>ppdcfile</b>(5),</a>
-<a href="man-ppdi.html?TOPIC=Man+Pages"><b>ppdi</b>(1),</a>
-<a href="man-ppdmerge.html?TOPIC=Man+Pages"><b>ppdmerge</b>(1),</a>
-<a href="man-ppdpo.html?TOPIC=Man+Pages"><b>ppdpo</b>(1),</a>
+<b>ppdc</b>(1),
+<b>ppdcfile</b>(5),
+<b>ppdi</b>(1),
+<b>ppdmerge</b>(1),
+<b>ppdpo</b>(1),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
Otherwise the existing file is merged with the new PPD file(s) on the command-line.
If no source file is specified, the filename <i>ppdi.drv</i> is used.
</dl>
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ppdc.html?TOPIC=Man+Pages"><b>ppdc</b>(1),</a>
-<a href="man-ppdhtml.html?TOPIC=Man+Pages"><b>ppdhtml</b>(1),</a>
-<a href="man-ppdmerge.html?TOPIC=Man+Pages"><b>ppdmerge</b>(1),</a>
-<a href="man-ppdpo.html?TOPIC=Man+Pages"><b>ppdpo</b>(1),</a>
-<a href="man-ppdcfile.html?TOPIC=Man+Pages"><b>ppdcfile</b>(5),</a>
+<b>ppdc</b>(1),
+<b>ppdhtml</b>(1),
+<b>ppdmerge</b>(1),
+<b>ppdpo</b>(1),
+<b>ppdcfile</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
If the output file already exists, it is silently overwritten.
</dl>
<h2 class="title"><a name="NOTES">Notes</a></h2>
-<b>ppdmerge</b> does not check whether the merged PPD files are for the same device.
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
+<p><b>ppdmerge</b> does not check whether the merged PPD files are for the same device.
Merging of different device PPDs will yield unpredictable results.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ppdc.html?TOPIC=Man+Pages"><b>ppdc</b>(1),</a>
-<a href="man-ppdhtml.html?TOPIC=Man+Pages"><b>ppdhtml</b>(1),</a>
-<a href="man-ppdi.html?TOPIC=Man+Pages"><b>ppdi</b>(1),</a>
-<a href="man-ppdpo.html?TOPIC=Man+Pages"><b>ppdpo</b>(1),</a>
-<a href="man-ppdcfile.html?TOPIC=Man+Pages"><b>ppdcfile</b>(5),</a>
+<b>ppdc</b>(1),
+<b>ppdhtml</b>(1),
+<b>ppdi</b>(1),
+<b>ppdpo</b>(1),
+<b>ppdcfile</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<dd style="margin-left: 5.0em">Specifies the output file.
The supported extensions are <i>.po</i> or <i>.po.gz</i> for GNU gettext format message catalogs and <i>.strings</i> for macOS strings files.
</dl>
+<h2 class="title"><a name="NOTES">Notes</a></h2>
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+<b>ippeveprinter</b>(1).
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-ppdc.html?TOPIC=Man+Pages"><b>ppdc</b>(1),</a>
-<a href="man-ppdhtml.html?TOPIC=Man+Pages"><b>ppdhtml</b>(1),</a>
-<a href="man-ppdi.html?TOPIC=Man+Pages"><b>ppdi</b>(1),</a>
-<a href="man-ppdmerge.html?TOPIC=Man+Pages"><b>ppdmerge</b>(1),</a>
+<b>ppdc</b>(1),
+<b>ppdhtml</b>(1),
+<b>ppdi</b>(1),
+<b>ppdmerge</b>(1),
<b>ppdcfile(5),</b>
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
printers.conf - printer configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
The <b>printers.conf</b> file defines the local printers that are available. It is normally located in the <i>/etc/cups</i> directory and is maintained by the
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8)</a>
+<b>cupsd</b>(8)
program. This file is not intended to be edited or managed manually.
<h2 class="title"><a name="NOTES">Notes</a></h2>
The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
-<a href="man-subscriptions.conf.html?TOPIC=Man+Pages"><b>subscriptions.conf</b>(5),</a>
+<b>classes.conf</b>(5),
+<b>cups-files.conf</b>(5),
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
+<b>mime.convs</b>(5),
+<b>mime.types</b>(5),
+<b>subscriptions.conf</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
<h2 class="title"><a name="NAME">Name</a></h2>
subscriptions.conf - subscription configuration file for cups
<h2 class="title"><a name="DESCRIPTION">Description</a></h2>
-The <b>subscriptions.conf</b> file defines the local event notification subscriptions that are active. It is normally located in the <i>/etc/cups</i> directory and is maintained by the
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8)</a>
-program. This file is not intended to be edited or managed manually.
+The <b>subscriptions.conf</b> file defines the local event notification subscriptions that are active.
+It is normally located in the <i>/etc/cups</i> directory and is maintained by the
+<b>cupsd</b>(8)
+program.
+This file is not intended to be edited or managed manually.
<h2 class="title"><a name="NOTES">Notes</a></h2>
The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
<h2 class="title"><a name="SEE_ALSO">See Also</a></h2>
-<a href="man-classes.conf.html?TOPIC=Man+Pages"><b>classes.conf</b>(5),</a>
-<a href="man-cupsd.html?TOPIC=Man+Pages"><b>cupsd</b>(8),</a>
-<a href="man-cupsd.conf.html?TOPIC=Man+Pages"><b>cupsd.conf</b>(5),</a>
-<a href="man-mime.convs.html?TOPIC=Man+Pages"><b>mime.convs</b>(5),</a>
-<a href="man-mime.types.html?TOPIC=Man+Pages"><b>mime.types</b>(5),</a>
-<a href="man-printers.conf.html?TOPIC=Man+Pages"><b>printers.conf</b>(5),</a>
+<b>classes.conf</b>(5),
+<b>cups-files.conf</b>(5),
+<b>cupsd</b>(8),
+<b>cupsd.conf</b>(5),
+<b>mime.convs</b>(5),
+<b>mime.types</b>(5),
+<b>printers.conf</b>(5),
CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
<h2 class="title"><a name="COPYRIGHT">Copyright</a></h2>
-Copyright © 2007-2018 by Apple Inc.
+Copyright © 2007-2019 by Apple Inc.
</body>
</html>
#
# Man page makefile for CUPS.
#
-# Copyright 2007-2019 by Apple Inc.
-# Copyright 1993-2006 by Easy Software Products.
+# Copyright © 2007-2019 by Apple Inc.
+# Copyright © 1993-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.
#
include ../Makedefs
# Man pages...
#
-MAN1 = cancel.$(MAN1EXT) \
- cups.$(MAN1EXT) \
- cups-config.$(MAN1EXT) \
- cupstestppd.$(MAN1EXT) \
- ippeveprinter.$(MAN1EXT) \
+MAN1 = cancel.1 \
+ cups.1 \
+ cups-config.1 \
+ cupstestppd.1 \
+ ippeveprinter.1 \
$(IPPFIND_MAN) \
- ipptool.$(MAN1EXT) \
- lp.$(MAN1EXT) \
- lpoptions.$(MAN1EXT) \
- lpq.$(MAN1EXT) \
- lprm.$(MAN1EXT) \
- lpr.$(MAN1EXT) \
- lpstat.$(MAN1EXT) \
- ppdc.$(MAN1EXT) \
- ppdhtml.$(MAN1EXT) \
- ppdi.$(MAN1EXT) \
- ppdmerge.$(MAN1EXT) \
- ppdpo.$(MAN1EXT)
-MAN5 = classes.conf.$(MAN5EXT) \
- client.conf.$(MAN5EXT) \
- cups-files.conf.$(MAN5EXT) \
- cups-snmp.conf.$(MAN5EXT) \
- cupsd.conf.$(MAN5EXT) \
- cupsd-logs.$(MAN5EXT) \
- ipptoolfile.$(MAN5EXT) \
- mailto.conf.$(MAN5EXT) \
- mime.convs.$(MAN5EXT) \
- mime.types.$(MAN5EXT) \
- ppdcfile.$(MAN5EXT) \
- printers.conf.$(MAN5EXT) \
- subscriptions.conf.$(MAN5EXT)
-MAN7 = backend.$(MAN7EXT) \
- filter.$(MAN7EXT) \
- ippevepcl.$(MAN7EXT) \
- notifier.$(MAN7EXT)
-MAN8 = cupsaccept.$(MAN8EXT) \
- cupsctl.$(MAN8EXT) \
- cupsfilter.$(MAN8EXT) \
- cups-lpd.$(MAN8EXT) \
- cups-snmp.$(MAN8EXT) \
- cupsd.$(MAN8EXT) \
- cupsd-helper.$(MAN8EXT) \
- cupsenable.$(MAN8EXT) \
- lpadmin.$(MAN8EXT) \
- lpinfo.$(MAN8EXT) \
- lpmove.$(MAN8EXT) \
- lpc.$(MAN8EXT)
+ ipptool.1 \
+ lp.1 \
+ lpoptions.1 \
+ lpq.1 \
+ lprm.1 \
+ lpr.1 \
+ lpstat.1 \
+ ppdc.1 \
+ ppdhtml.1 \
+ ppdi.1 \
+ ppdmerge.1 \
+ ppdpo.1
+MAN5 = classes.conf.5 \
+ client.conf.5 \
+ cups-files.conf.5 \
+ cups-snmp.conf.5 \
+ cupsd.conf.5 \
+ cupsd-logs.5 \
+ ipptoolfile.5 \
+ mailto.conf.5 \
+ mime.convs.5 \
+ mime.types.5 \
+ ppdcfile.5 \
+ printers.conf.5 \
+ subscriptions.conf.5
+MAN7 = backend.7 \
+ filter.7 \
+ ippevepcl.7 \
+ notifier.7
+MAN8 = cupsaccept.8 \
+ cupsctl.8 \
+ cupsfilter.8 \
+ cups-lpd.8 \
+ cups-snmp.8 \
+ cupsd.8 \
+ cupsd-helper.8 \
+ cupsenable.8 \
+ lpadmin.8 \
+ lpinfo.8 \
+ lpmove.8 \
+ lpc.8
#
clean:
$(RM) mantohtml mantohtml.o
- $(RM) $(MAN1) $(MAN5) $(MAN7) $(MAN8)
#
#
install-data: all
+ echo Installing man pages in $(MANDIR)/man1...
$(INSTALL_DIR) -m 755 $(MANDIR)/man1
for file in $(MAN1); do \
- echo Installing $$file in $(MANDIR)/man1...; \
$(INSTALL_MAN) $$file $(MANDIR)/man1; \
done
+ echo Installing man pages in $(MANDIR)/man5...
$(INSTALL_DIR) -m 755 $(MANDIR)/man5
for file in $(MAN5); do \
- echo Installing $$file in $(MANDIR)/man5...; \
$(INSTALL_MAN) $$file $(MANDIR)/man5; \
done
+ echo Installing man pages in $(MANDIR)/man7...
$(INSTALL_DIR) -m 755 $(MANDIR)/man7
for file in $(MAN7); do \
- echo Installing $$file in $(MANDIR)/man7...; \
$(INSTALL_MAN) $$file $(MANDIR)/man7; \
done
- $(RM) $(MANDIR)/man7/ippeveps.$(MAN7EXT)
- $(LN) ippevepcl.$(MAN7EXT) $(MANDIR)/man7/ippeveps.$(MAN7EXT)
- $(INSTALL_DIR) -m 755 $(AMANDIR)/man$(MAN8DIR)
+ $(RM) $(MANDIR)/man7/ippeveps.7
+ $(LN) ippevepcl.7 $(MANDIR)/man7/ippeveps.7
+ echo Installing man pages in $(MANDIR)/man8...
+ $(INSTALL_DIR) -m 755 $(MANDIR)/man8
for file in $(MAN8); do \
- echo Installing $$file in $(AMANDIR)/man$(MAN8DIR)...; \
- $(INSTALL_MAN) $$file $(AMANDIR)/man$(MAN8DIR); \
+ $(INSTALL_MAN) $$file $(MANDIR)/man8; \
done
- for file in accept cupsreject reject; do \
- $(RM) $(AMANDIR)/man$(MAN8DIR)/$$file.$(MAN8EXT); \
- $(LN) cupsaccept.$(MAN8EXT) $(AMANDIR)/man$(MAN8DIR)/$$file.$(MAN8EXT); \
- done
- $(RM) $(AMANDIR)/man$(MAN8DIR)/cupsdisable.$(MAN8EXT)
- $(LN) cupsenable.$(MAN8EXT) $(AMANDIR)/man$(MAN8DIR)/cupsdisable.$(MAN8EXT)
- for file in cups-deviced cups-driverd cups-exec; do \
- $(RM) $(AMANDIR)/man$(MAN8DIR)/$$file.$(MAN8EXT); \
- $(LN) cupsd-helper.$(MAN8EXT) $(AMANDIR)/man$(MAN8DIR)/$$file.$(MAN8EXT); \
+ $(RM) $(MANDIR)/man8/cupsenable.8
+ $(LN) cupsdisable.8 $(MANDIR)/man8/cupsenable.8
+ $(RM) $(MANDIR)/man8/cupsreject.8
+ $(LN) cupsaccept.8 $(MANDIR)/man8/cupsreject.8
+ for file in cups-deviced.8 cups-driverd.8 cups-exec.8; do \
+ $(RM) $(MANDIR)/man8/$$file; \
+ $(LN) cupsd-helper.8 $(MANDIR)/man8/$$file; \
done
#
uninstall:
+ echo Uninstalling man pages from $(MANDIR)/man1...
for file in $(MAN1); do \
$(RM) $(MANDIR)/man1/$$file; \
done
-$(RMDIR) $(MANDIR)/man1
+ echo Uninstalling man pages from $(MANDIR)/man5...
for file in $(MAN5); do \
$(RM) $(MANDIR)/man5/$$file; \
done
-$(RMDIR) $(MANDIR)/man5
- for file in $(MAN7); do \
+ echo Uninstalling man pages from $(MANDIR)/man7...
+ for file in $(MAN7) ippeveps.7; do \
$(RM) $(MANDIR)/man7/$$file; \
done
-$(RMDIR) $(MANDIR)/man7
- for file in $(MAN8); do \
- $(RM) $(AMANDIR)/man$(MAN8DIR)/$$file; \
+ echo Uninstalling man pages from $(MANDIR)/man8...
+ for file in $(MAN8) cupsenable.8 cupsreject.8 cups-deviced.8 cups-driverd.8 cups-exec.8; do \
+ $(RM) $(MANDIR)/man8/$$file; \
done
- $(RM) $(AMANDIR)/man$(MAN8DIR)/accept.$(MAN8EXT)
- $(RM) $(AMANDIR)/man$(MAN8DIR)/cupsreject.$(MAN8EXT)
- $(RM) $(AMANDIR)/man$(MAN8DIR)/reject.$(MAN8EXT)
- $(RM) $(AMANDIR)/man$(MAN8DIR)/cupsdisable.$(MAN8EXT)
- -$(RMDIR) $(AMANDIR)/man$(MAN8DIR)
+ -$(RMDIR) $(MANDIR)/man8
#
echo Converting man pages to HTML...
for file in $(MAN1); do \
echo " $$file..."; \
- ./mantohtml `basename $$file .$(MAN1EXT)`.man >../doc/help/man-`basename $$file .$(MAN1EXT)`.html; \
+ ./mantohtml $$file >../doc/help/man-`basename $$file .1`.html; \
done
for file in $(MAN5); do \
echo " $$file..."; \
- ./mantohtml `basename $$file .$(MAN5EXT)`.man >../doc/help/man-`basename $$file .$(MAN5EXT)`.html; \
+ ./mantohtml $$file >../doc/help/man-`basename $$file .5`.html; \
done
for file in $(MAN7); do \
echo " $$file..."; \
- ./mantohtml `basename $$file .$(MAN7EXT)`.man >../doc/help/man-`basename $$file .$(MAN7EXT)`.html; \
+ ./mantohtml $$file >../doc/help/man-`basename $$file .7`.html; \
done
for file in $(MAN8); do \
echo " $$file..."; \
- ./mantohtml `basename $$file .$(MAN8EXT)`.man >../doc/help/man-`basename $$file .$(MAN8EXT)`.html; \
+ ./mantohtml $$file >../doc/help/man-`basename $$file .8`.html; \
done
mantohtml: mantohtml.o ../cups/$(LIBCUPSSTATIC)
.\"
.\" Backend man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 backend 7 "CUPS" "4 April 2014" "Apple Inc."
+.TH backend 7 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
backend \- cups backend transmission interfaces
.SH SYNOPSIS
.LP
Like filters, backends must be capable of reading from a filename on the command-line or from the standard input, copying the standard input to a temporary file as required by the physical interface.
.LP
-The command name (\fIargv[0]\fR) is set to the device URI of the destination printer. Authentication information in
+The command name (\fIargv[0]\fR) is set to the device URI of the destination printer.
+Authentication information in
.I argv[0]
is removed, so backend developers are urged to use the
.B DEVICE_URI
.B CUPS_SC_FD
constant defines the file descriptor that should be monitored for incoming requests.
.SS DEVICE DISCOVERY
-When run with no arguments, the backend should list the devices and schemes it supports or is advertising to the standard output. The output consists of zero or more lines consisting of any of the following forms:
+When run with no arguments, the backend should list the devices and schemes it supports or is advertising to the standard output.
+The output consists of zero or more lines consisting of any of the following forms:
.nf
device-class scheme "Unknown" "device-info"
network URIs.
.TP 5
.B serial
-The device-uri refers to a serial device with configurable baud rate and other options. If the device-uri contains a baud value, it represents the maximum baud rate supported by the device.
+The device-uri refers to a serial device with configurable baud rate and other options.
+If the device-uri contains a baud value, it represents the maximum baud rate supported by the device.
.LP
The
.I scheme
-field provides the URI scheme that is supported by the backend. Backends should use this form only when the backend supports any URI using that scheme. The
+field provides the URI scheme that is supported by the backend.
+Backends should use this form only when the backend supports any URI using that scheme.
+The
.I device-uri
field specifies the full URI to use when communicating with the device.
.LP
The
.I device-make-and-model
-field specifies the make and model of the device, e.g. "Example Foojet 2000". If the make and model is not known, you must report "Unknown".
+field specifies the make and model of the device, e.g. "Example Foojet 2000".
+If the make and model is not known, you must report "Unknown".
.LP
The
.I device-info
-field specifies additional information about the device. Typically this includes the make and model along with the port number or network address, e.g. "Example Foojet 2000 USB #1".
+field specifies additional information about the device.
+Typically this includes the make and model along with the port number or network address, e.g. "Example Foojet 2000 USB #1".
.LP
The optional
.I device-id
.I device-location
field specifies the physical location of the device, which is often used to pre-populate the printer-location attribute when adding a printer.
.SS PERMISSIONS
-Backends without world read and execute permissions are run as the root user. Otherwise, the backend is run using an unprivileged user account, typically "lp".
+Backends without world read and execute permissions are run as the root user.
+Otherwise, the backend is run using an unprivileged user account, typically "lp".
.SH EXIT STATUS
The following exit codes are defined for backends:
.TP 5
.TP 5
.B CUPS_BACKEND_FAILED
.br
-The print file was not successfully transmitted to the device or remote server. The scheduler will respond to this by canceling the job, retrying the job, or stopping the queue depending on the state of the
+The print file was not successfully transmitted to the device or remote server.
+The scheduler will respond to this by canceling the job, retrying the job, or stopping the queue depending on the state of the
.I printer-error-policy
attribute.
.TP 5
.B CUPS_BACKEND_AUTH_REQUIRED
-The print file was not successfully transmitted because valid authentication information is required. The scheduler will respond to this by holding the job and adding the 'cups-held-for-authentication' keyword to the "job-reasons" Job Description attribute.
+The print file was not successfully transmitted because valid authentication information is required.
+The scheduler will respond to this by holding the job and adding the 'cups-held-for-authentication' keyword to the "job-reasons" Job Description attribute.
.TP 5
.B CUPS_BACKEND_HOLD
-The print file was not successfully transmitted because it cannot be printed at this time. The scheduler will respond to this by holding the job.
+The print file was not successfully transmitted because it cannot be printed at this time.
+The scheduler will respond to this by holding the job.
.TP 5
.B CUPS_BACKEND_STOP
-The print file was not successfully transmitted because it cannot be printed at this time. The scheduler will respond to this by stopping the queue.
+The print file was not successfully transmitted because it cannot be printed at this time.
+The scheduler will respond to this by stopping the queue.
.TP 5
.B CUPS_BACKEND_CANCEL
-The print file was not successfully transmitted because one or more attributes are not supported or the job was canceled at the printer. The scheduler will respond to this by canceling the job.
+The print file was not successfully transmitted because one or more attributes are not supported or the job was canceled at the printer.
+The scheduler will respond to this by canceling the job.
.TP 5
.B CUPS_BACKEND_RETRY
-The print file was not successfully transmitted because of a temporary issue. The scheduler will retry the job at a future time - other jobs may print before this one.
+The print file was not successfully transmitted because of a temporary issue.
+The scheduler will retry the job at a future time - other jobs may print before this one.
.TP 5
.B CUPS_BACKEND_RETRY_CURRENT
-The print file was not successfully transmitted because of a temporary issue. The scheduler will retry the job immediately without allowing intervening jobs.
+The print file was not successfully transmitted because of a temporary issue.
+The scheduler will retry the job immediately without allowing intervening jobs.
.PP
All other exit code values are reserved.
.SH ENVIRONMENT
.SH FILES
.I /etc/cups/cups-files.conf
.SH NOTES
-CUPS backends are not generally designed to be run directly by the user. Aside from the device URI issue (
+CUPS backends are not generally designed to be run directly by the user.
+Aside from the device URI issue (
.I argv[0]
and
.B DEVICE_URI
-environment variable contain the device URI), CUPS backends also expect specific environment variables and file descriptors, and typically run in a user session that (on macOS) has additional restrictions that affect how it runs. Backends can also be installed with restricted permissions (0500 or 0700) that tell the scheduler to run them as the "root" user instead of an unprivileged user (typically "lp") on the system.
+environment variable contain the device URI), CUPS backends also expect specific environment variables and file descriptors, and typically run in a user session that (on macOS) has additional restrictions that affect how it runs.
+Backends can also be installed with restricted permissions (0500 or 0700) that tell the scheduler to run them as the "root" user instead of an unprivileged user (typically "lp") on the system.
.LP
-Unless you are a developer and know what you are doing, please do not run backends directly. Instead, use the
+Unless you are a developer and know what you are doing, please do not run backends directly.
+Instead, use the
.BR lp (1)
or
.BR lpr (1)
programs to send print jobs or
.BR lpinfo (8)
-to query for available printers using the backend. The one exception is the SNMP backend - see
+to query for available printers using the backend.
+The one exception is the SNMP backend - see
.BR cups-snmp (8)
for more information.
+.SH NOTES
+CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
.SH SEE ALSO
.IR cups (1),
.IR cups-files.conf (5),
.br
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cancel man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 cancel 1 "CUPS" "15 April 2014" "Apple Inc."
+.TH cancel 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cancel \- cancel jobs
.SH SYNOPSIS
.BR lpstat (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" classes.conf man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 classes.conf 5 "CUPS" "15 April 2014" "Apple Inc."
+.TH classes.conf 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
classes.conf \- class configuration file for cups
.SH DESCRIPTION
-The \fBclasses.conf\fR file defines the local printer classes that are available. It is normally located in the \fI/etc/cups\fR directory and is maintained by the
+The \fBclasses.conf\fR file defines the local printer classes that are available.
+It is normally located in the \fI/etc/cups\fR directory and is maintained by the
.BR cupsd (8)
-program. This file is not intended to be edited or managed manually.
+program.
+This file is not intended to be edited or managed manually.
.SH NOTES
The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
.SH SEE ALSO
.BR subscriptions.conf (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" client.conf man page for CUPS.
.\"
-.\" Copyright 2007-2018 by Apple Inc.
-.\" Copyright 2006 by Easy Software Products.
+.\" Copyright © 2007-2019 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 client.conf 5 "CUPS" "15 April 2019" "Apple Inc."
+.TH client.conf 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
-client.conf \- client configuration file for cups
+client.conf \- client configuration file for cups (deprecated on macos)
.SH DESCRIPTION
The \fBclient.conf\fR file configures the CUPS client and is normally located in the \fI/etc/cups\fR and/or \fI~/.cups\fR directories.
Each line in the file can be a configuration directive, a blank line, or a comment. Comment lines start with the # character.
.BR default (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cups-config man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 cups-config 1 "CUPS" "15 April 2014" "Apple Inc."
+.TH cups-config 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cups\-config \- get cups api, compiler, directory, and link information.
.SH SYNOPSIS
.B \-\-help
Reports the program usage message.
.TP 5
-.B \-\-image
-When used with \fI\-\-libs\fR, adds the CUPS imaging library to the
-list of libraries.
-.TP 5
.B \-\-ldflags
Reports the necessary linker options.
.TP 5
cc `cups\-config \-\-cflags \-\-ldflags` \-o filter filter.c \\
`cups\-config \-\-libs`
.fi
+.SH DEPRECATED OPTIONS
+The following options are deprecated but continue to work for backwards compatibility:
+.TP 5
+.B \-\-image
+Formerly used to add the CUPS imaging library to the list of libraries.
.SH SEE ALSO
.BR cups (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cups-files.conf man page for CUPS.
.\"
-.\" Copyright © 2007-2018 by Apple Inc.
+.\" Copyright © 2007-2019 by Apple Inc.
.\" Copyright © 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
-.TH cups-files.conf 5 "CUPS" "8 November 2018" "Apple Inc."
+.TH cups-files.conf 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cups\-files.conf \- file and directory configuration file for cups
.SH DESCRIPTION
.BR subscriptions.conf (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cups-lpd man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 cups-lpd 8 "CUPS" "3 June 2014" "Apple Inc."
+.TH cups-lpd 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
-cups-lpd \- receive print jobs and report printer status to lpd clients
+cups-lpd \- receive print jobs and report printer status to lpd clients (deprecated)
.SH SYNOPSIS
.B cups-lpd
[
.I /System/Library/LaunchDaemons/org.cups.cups-lpd.plist
.fi
.SH NOTES
+The
+.B cups-lpd
+program is deprecated and will no longer be supported in a future feature release of CUPS.
.SS PERFORMANCE
.B cups-lpd
performs well with small numbers of clients and printers.
CUPS Online Help (http://localhost:631/help),
RFC 2569
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" SNMP backend man page for CUPS.
.\"
-.\" Copyright © 2012-2018 by Apple Inc.
+.\" Copyright © 2012-2019 by Apple Inc.
.\"
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
-.TH cups-snmp 8 "CUPS" "8 November 2018" "Apple Inc."
+.TH cups-snmp 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
-snmp \- cups snmp backend
+snmp \- cups snmp backend (deprecated)
.SH SYNOPSIS
.B /usr/lib/cups/backend/snmp
.I ip-address-or-hostname
.BR lpinfo (8),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" snmp.conf man page for CUPS.
.\"
-.\" Copyright © 2007-2018 by Apple Inc.
+.\" Copyright © 2007-2019 by Apple Inc.
.\" Copyright © 2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
-.TH snmp.conf 5 "CUPS" "8 November 2018" "Apple Inc."
+.TH snmp.conf 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
-snmp.conf \- snmp configuration file for cups
+snmp.conf \- snmp configuration file for cups (deprecated)
.SH DESCRIPTION
The
.B snmp.conf
Specifies the maximum number of seconds that the SNMP backend will scan the
network for printers.
The default is 120 seconds (2 minutes).
+.SH NOTES
+CUPS backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
.SH SEE ALSO
.BR cups-snmp (8),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cups (intro) man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 cups 1 "CUPS" "16 April 2014" "Apple Inc."
+.TH cups 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cups \- a standards-based, open source printing system
.SH DESCRIPTION
.SH CONFORMING TO
.B CUPS
conforms to the Internet Printing Protocol version 2.1 and implements the Berkeley and System V UNIX print commands.
+.SH NOTES
+CUPS printer drivers, backends, and PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
.SH SEE ALSO
.BR cancel (1),
.BR client.conf (7),
CUPS Web Site (http://www.CUPS.org),
PWG Internet Printing Protocol Workgroup (http://www.pwg.org/ipp)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
-.\" accept/reject man page for CUPS.
+.\" cupsaccept/reject man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 cupsaccept 8 "CUPS" "10 June 2014" "Apple Inc."
+.TH cupsaccept 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cupsaccept/cupsreject \- accept/reject jobs sent to a destination
.SH SYNOPSIS
.br
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cupsctl man page for CUPS.
.\"
-.\" Copyright 2007-2016 by Apple Inc.
-.\" Copyright 2007 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 2007 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 cupsctl 8 "CUPS" "30 May 2016" "Apple Inc."
+.TH cupsctl 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cupsctl \- configure cupsd.conf options
.SH SYNOPSIS
.br
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cupsd-helper man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
+.\" Copyright 2007-2019 by Apple Inc.
.\" Copyright 1997-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 cupsd-helper 8 "CUPS" "15 April 2014" "Apple Inc."
+.TH cupsd-helper 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
-cupsd\-helper \- cupsd helper programs
+cupsd\-helper \- cupsd helper programs (deprecated)
.SH SYNOPSIS
.B cups\-deviced
.I request-id
.LP
Driver information files must conform to the format defined in
.BR ppdcfile (5).
+.SH NOTES
+CUPS printer drivers, backends, and PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
.SH SEE ALSO
.BR backend (7),
.BR cups (1),
.BR ppdcfile (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cupsd-logs man page for CUPS.
.\"
-.\" Copyright 2007-2018 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
-.TH cupsd-logs 5 "CUPS" "8 November 2017" "Apple Inc."
+.TH cupsd-logs 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cupsd\-logs \- cupsd log files (access_log, error_log, and page_log)
.SH DESCRIPTION
.BR cups-files.conf (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cupsd man page for CUPS.
.\"
-.\" Copyright 2007-2016 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 cupsd 8 "CUPS" "12 February 2016" "Apple Inc."
+.TH cupsd 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cupsd \- cups scheduler
.SH SYNOPSIS
.BR systemd (8),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cupsd.conf man page for CUPS.
.\"
-.\" Copyright © 2007-2018 by Apple Inc.
+.\" Copyright © 2007-2019 by Apple Inc.
.\" Copyright © 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
-.TH cupsd.conf 5 "CUPS" "15 April 2019" "Apple Inc."
+.TH cupsd.conf 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cupsd.conf \- server configuration file for cups
.SH DESCRIPTION
.BR subscriptions.conf (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cupsenable/cupsdisable man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 cupsenable 8 "CUPS" "11 June 2014" "Apple Inc."
+.TH cupsenable 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cupsdisable, cupsenable \- stop/start printers and classes
.SH SYNOPSIS
.BR lpstat (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cupsfilter man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
+.\" Copyright 2007-2019 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 cupsfilter 8 "CUPS" "11 June 2014" "Apple Inc."
+.TH cupsfilter 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
-cupsfilter \- convert a file to another format using cups filters
+cupsfilter \- convert a file to another format using cups filters (deprecated)
.SH SYNOPSIS
.B cupsfilter
[
/usr/share/cups/mime/*.convs
/usr/share/cups/mime/*.types
.SH NOTES
+CUPS printer drivers, filters, and backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
+.LP
Unlike when printing, filters run using the
.B cupsfilter
command use the current user and security session. This may result in different output or unexpected behavior.
.BR mime.types (7),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" cupstestppd man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 cupstestppd 1 "CUPS" "11 June 2014" "Apple Inc."
+.TH cupstestppd 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
cupstestppd \- test conformance of ppd files
.SH SYNOPSIS
find . \-name \\*.ppd \\! \-exec cupstestppd \-q '{}' \\; \\
\-exec cupstestppd \-v '{}' \\;
.fi
+.SH NOTES
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
.SH SEE ALSO
.BR lpadmin (8),
CUPS Online Help (http://localhost:631/help),
Adobe PostScript Printer Description File Format Specification, Version 4.3.
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" filter man page for CUPS.
.\"
-.\" Copyright 2007-2015 by Apple Inc.
-.\" Copyright 1997-2007 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-2007 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 filter 7 "CUPS" "19 October 2015" "Apple Inc."
+.TH filter 7 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
filter \- cups file conversion filter interface
.SH SYNOPSIS
.SH CONFORMING TO
While the filter interface is compatible with System V interface scripts, CUPS does not support System V interface scripts.
.SH NOTES
+CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
+.LP
CUPS filters are not meant to be run directly by the user.
Aside from the legacy System V interface issues (\fIargv[0]\fR is the printer name), CUPS filters also expect specific environment variables and file descriptors, and typically run in a user session that (on macOS) has additional restrictions that affect how it runs.
Unless you are a developer and know what you are doing, please do not run filters directly.
.br
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" ippfind man page.
.\"
-.\" Copyright © 2013-2018 by Apple Inc.
+.\" Copyright © 2013-2019 by Apple Inc.
.\"
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
-.TH ippfind 1 "ippsample" "14 February 2018" "Apple Inc."
+.TH ippfind 1 "ippsample" "26 April 2019" "Apple Inc."
.SH NAME
ippfind \- find internet printing protocol printers
.SH SYNOPSIS
.SH SEE ALSO
.BR ipptool (1)
.SH COPYRIGHT
-Copyright \[co] 2013-2018 by Apple Inc.
+Copyright \[co] 2013-2019 by Apple Inc.
.\"
.\" ipptool man page.
.\"
-.\" Copyright 2010-2018 by Apple Inc.
+.\" Copyright © 2010-2019 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 ipptool 1 "CUPS" "1 November 2017" "Apple Inc."
+.TH ipptool 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
ipptool \- perform internet printing protocol requests
.SH SYNOPSIS
PWG Internet Printing Protocol Workgroup (http://www.pwg.org/ipp)
RFC 8011 (http://tools.ietf.org/html/rfc8011),
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" ipptoolfile man page.
.\"
-.\" Copyright 2010-2018 by Apple Inc.
+.\" Copyright © 2010-2019 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 ipptoolfile 5 "CUPS" "15 June 2017" "Apple Inc."
+.TH ipptoolfile 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
ipptoolfile \- ipptool file format
.SH DESCRIPTION
PWG Internet Printing Protocol Workgroup (http://www.pwg.org/ipp),
RFC 8011 (http://tools.ietf.org/html/rfc8011)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" lp man page for CUPS.
.\"
-.\" Copyright © 2007-2018 by Apple Inc.
+.\" Copyright © 2007-2019 by Apple Inc.
.\" Copyright © 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
-.TH lp 1 "CUPS" "6 December 2018" "Apple Inc."
+.TH lp 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
lp \- print files
.SH SYNOPSIS
.BR lpstat (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" lpadmin man page for CUPS.
.\"
-.\" Copyright 2007-2018 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 lpadmin 8 "CUPS" "8 November 2018" "Apple Inc."
+.TH lpadmin 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
lpadmin \- configure cups printers and classes
.SH SYNOPSIS
Finally, the CUPS version of \fBlpadmin\fR may ask the user for an access password depending on the printing system configuration.
This differs from the System V version which requires the root user to execute this command.
.SH NOTES
+CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
+.LP
The CUPS version of \fBlpadmin\fR does not support all of the System V or Solaris printing system configuration options.
.PP
Interface scripts are not supported for security reasons.
.BR lpoptions (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" lpc man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 lpc 8 "CUPS" "11 June 2014" "Apple Inc."
+.TH lpc 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
-lpc \- line printer control program
+lpc \- line printer control program (deprecated)
.SH SYNOPSIS
.B lpc
[
\fBstatus \fR[\fIqueue\fR]
Displays the status of one or more printer or class queues.
.SH NOTES
+This program is deprecated and will be removed in a future feature release of CUPS.
+.LP
Since \fBlpc\fR is geared towards the Berkeley printing system, it is impossible to use \fBlpc\fR to configure printer or class queues provided by CUPS.
To configure printer or class queues you must use the
.BR lpadmin (8)
.BR lpstat (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" lpinfo man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 lpinfo 8 "CUPS" "12 June 2014" "Apple Inc."
+.TH lpinfo 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
-lpinfo \- show available devices or drivers
+lpinfo \- show available devices or drivers (deprecated)
.SH SYNOPSIS
.B lpinfo
[
lpinfo \-\-make\-and\-model "HP LaserJet" \-m
.fi
+.SH NOTES
+CUPS printer drivers and backends are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
.SH SEE ALSO
.BR lpadmin (8),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" lpmove man page for CUPS.
.\"
-.\" Copyright 2007-2016 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 lpmove 8 "CUPS" "26 May 2016" "Apple Inc."
+.TH lpmove 8 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
lpmove \- move a job or all jobs to a new destination
.SH SYNOPSIS
.br
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" lpoptions man page for CUPS.
.\"
-.\" Copyright © 2007-2018 by Apple Inc.
+.\" Copyright © 2007-2019 by Apple Inc.
.\" Copyright © 1997-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 lpoptions 1 "CUPS" "10 April 2018" "Apple Inc."
+.TH lpoptions 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
lpoptions \- display or set printer options and defaults
.SH SYNOPSIS
.BR lprm (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" lpq man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 lpq 1 "CUPS" "12 June 2014" "Apple Inc."
+.TH lpq 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
lpq \- show printer queue status
.SH SYNOPSIS
.BR lpstat (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" lpr man page for CUPS.
.\"
-.\" Copyright © 2007-2018 by Apple Inc.
+.\" Copyright © 2007-2019 by Apple Inc.
.\" Copyright © 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more
.\" information.
.\"
-.TH lpr 1 "CUPS" "6 December 2018" "Apple Inc."
+.TH lpr 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
lpr \- print files
.SH SYNOPSIS
.BR lpstat (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" lprm man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 lprm 1 "CUPS" "22 May 2014" "Apple Inc."
+.TH lprm 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
lprm \- cancel print jobs
.SH SYNOPSIS
.BR lpstat (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" lpstat man page for CUPS.
.\"
-.\" Copyright 2007-2018 by Apple Inc.
+.\" Copyright 2007-2019 by Apple Inc.
.\" Copyright 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more information.
.\"
-.TH lpstat 1 "CUPS" "26 May 2017" "Apple Inc."
+.TH lpstat 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
lpstat \- print cups status information
.SH SYNOPSIS
.BR lprm (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" mailto.conf man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 mailto.conf 5 "CUPS" "12 June 2014" "Apple Inc."
+.TH mailto.conf 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
mailto.conf \- configuration file for cups email notifier
.SH DESCRIPTION
.BR cupsd (8),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" mime.convs man page for CUPS.
.\"
-.\" Copyright 2007-2015 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 mime.convs 5 "CUPS" "26 August 2015" "Apple Inc."
+.TH mime.convs 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
-mime.convs \- mime type conversion file for cups
+mime.convs \- mime type conversion file for cups (deprecated)
.SH DESCRIPTION
The \fBmime.convs\fR file defines the filters that are available for converting files from one format to another.
The standard filters support text, PDF, PostScript, and many types of image files.
application/vnd.cups\-postscript application/vnd.cups\-raster 50 pstoraster
.fi
+.SH NOTES
+CUPS filters are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
.SH SEE ALSO
.BR cups-files.conf (5),
.BR cupsd.conf (5),
.BR mime.types (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" mime.types man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 mime.types 5 "CUPS" "12 June 2014" "Apple Inc."
+.TH mime.types 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
mime.types \- mime type description file for cups
.SH DESCRIPTION
.BR mime.convs (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" notifier man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2007 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-2007 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 notifier 7 "CUPS" "12 June 2014" "Apple Inc."
+.TH notifier 7 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
notifier \- cups notification interface
.SH SYNOPSIS
.BR filter (7),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" ppdc man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2007 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-2007 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 ppdc 1 "CUPS" "12 June 2014" "Apple Inc."
+.TH ppdc 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
ppdc \- cups ppd compiler (deprecated)
.SH SYNOPSIS
\fB\-\-lf\fR
Specifies the line ending to use - carriage return, carriage return and line feed, or line feed alone.
The default is to use the line feed character alone.
+.SH NOTES
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
.SH SEE ALSO
.BR ppdhtml (1),
.BR ppdi (1),
.BR ppdcfile (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" ppdcfile man page for CUPS.
.\"
-.\" Copyright 2007-2016 by Apple Inc.
-.\" Copyright 1997-2007 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-2007 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 ppdcfile 5 "CUPS" "5 March 2016" "Apple Inc."
+.TH ppdcfile 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
-ppdcfile \- cups ppd compiler source file format
+ppdcfile \- cups ppd compiler source file format (deprecated)
.SH DESCRIPTION
The CUPS PPD compiler reads meta files that contain descriptions of one or more PPD files to be generated by
.BR ppdc (1).
\fBVariablePaperSize \fIboolean-value\fR
.TP 5
\fBVersion \fInumber\fR
+.SH NOTES
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
.SH SEE ALSO
.BR ppdc (1),
.BR ppdhtml (1),
.BR ppdpo (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" ppdhtml man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2007 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-2007 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 ppdhtml 1 "CUPS" "12 June 2014" "Apple Inc."
+.TH ppdhtml 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
ppdhtml \- cups html summary generator (deprecated)
.SH SYNOPSIS
\fB\-I \fIinclude-directory\fR
Specifies an alternate include directory.
Multiple \fI-I\fR options can be supplied to add additional directories.
+.SH NOTES
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
.SH SEE ALSO
.BR ppdc (1),
.BR ppdcfile (5),
.BR ppdpo (1),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" ppdi man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2007 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-2007 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 ppdi 1 "CUPS" "12 June 2014" "Apple Inc."
+.TH ppdi 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
ppdi \- import ppd files (deprecated)
.SH SYNOPSIS
If the source file does not exist, a new source file is created.
Otherwise the existing file is merged with the new PPD file(s) on the command-line.
If no source file is specified, the filename \fIppdi.drv\fR is used.
+.SH NOTES
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
.SH SEE ALSO
.BR ppdc (1),
.BR ppdhtml (1),
.BR ppdcfile (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" ppdmerge man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2007 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-2007 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 ppdmerge 1 "CUPS" "12 June 2014" "Apple Inc."
+.TH ppdmerge 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
ppdmerge \- merge ppd files (deprecated)
.SH SYNOPSIS
If not specified, the merged PPD file is written to the standard output.
If the output file already exists, it is silently overwritten.
.SH NOTES
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
+.LP
\fBppdmerge\fR does not check whether the merged PPD files are for the same device.
Merging of different device PPDs will yield unpredictable results.
.SH SEE ALSO
.BR ppdcfile (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" ppdpo man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2007 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-2007 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 ppdpo 1 "CUPS" "12 June 2014" "Apple Inc."
+.TH ppdpo 1 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
ppdpo \- ppd message catalog generator (deprecated)
.SH SYNOPSIS
\fB\-o \fIoutput-file\fR
Specifies the output file.
The supported extensions are \fI.po\fR or \fI.po.gz\fR for GNU gettext format message catalogs and \fI.strings\fR for macOS strings files.
+.SH NOTES
+PPD files are deprecated and will no longer be supported in a future feature release of CUPS.
+Printers that do not support IPP can be supported using applications such as
+.BR ippeveprinter (1).
.SH SEE ALSO
.BR ppdc (1),
.BR ppdhtml (1),
.BR ppdcfile(5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" printers.conf man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
+.\" Copyright 2007-2019 by Apple Inc.
.\" Copyright 1997-2006 by Easy Software Products.
.\"
.\" Licensed under Apache License v2.0. See the file "LICENSE" for more information.
.\"
-.TH printers.conf 5 "CUPS" "15 April 2014" "Apple Inc."
+.TH printers.conf 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
printers.conf \- printer configuration file for cups
.SH DESCRIPTION
The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
.SH SEE ALSO
.BR classes.conf (5),
+.BR cups-files.conf (5),
.BR cupsd (8),
.BR cupsd.conf (5),
.BR mime.convs (5),
.BR subscriptions.conf (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
.\"
.\" subscriptions.conf man page for CUPS.
.\"
-.\" Copyright 2007-2014 by Apple Inc.
-.\" Copyright 1997-2006 by Easy Software Products.
+.\" Copyright © 2007-2019 by Apple Inc.
+.\" Copyright © 1997-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 subscriptions.conf 5 "CUPS" "15 April 2014" "Apple Inc."
+.TH subscriptions.conf 5 "CUPS" "26 April 2019" "Apple Inc."
.SH NAME
subscriptions.conf \- subscription configuration file for cups
.SH DESCRIPTION
-The \fBsubscriptions.conf\fR file defines the local event notification subscriptions that are active. It is normally located in the \fI/etc/cups\fR directory and is maintained by the
+The \fBsubscriptions.conf\fR file defines the local event notification subscriptions that are active.
+It is normally located in the \fI/etc/cups\fR directory and is maintained by the
.BR cupsd (8)
-program. This file is not intended to be edited or managed manually.
+program.
+This file is not intended to be edited or managed manually.
.SH NOTES
The name, location, and format of this file are an implementation detail that will change in future releases of CUPS.
.SH SEE ALSO
.BR classes.conf (5),
+.BR cups-files.conf (5),
.BR cupsd (8),
.BR cupsd.conf (5),
.BR mime.convs (5),
.BR printers.conf (5),
CUPS Online Help (http://localhost:631/help)
.SH COPYRIGHT
-Copyright \[co] 2007-2018 by Apple Inc.
+Copyright \[co] 2007-2019 by Apple Inc.
projects / thirdparty / cups.git / commitdiff
