]> git.ipfire.org Git - thirdparty/cups.git/blob - man/notifier.7
1ab226c408fa31be753d2cdc4a0127e987b8de19
[thirdparty/cups.git] / man / notifier.7
1 .\"
2 .\" notifier man page for CUPS.
3 .\"
4 .\" Copyright © 2007-2019 by Apple Inc.
5 .\" Copyright © 1997-2007 by Easy Software Products.
6 .\"
7 .\" Licensed under Apache License v2.0. See the file "LICENSE" for more
8 .\" information.
9 .\"
10 .TH notifier 7 "CUPS" "26 April 2019" "Apple Inc."
11 .SH NAME
12 notifier \- cups notification interface
13 .SH SYNOPSIS
14 .B notifier
15 .I recipient
16 [
17 .I user-data
18 ]
19 .SH DESCRIPTION
20 The CUPS notifier interface provides a standard method for adding support for new event notification methods to CUPS.
21 Each notifier delivers one or more IPP events from the standard input to the specified recipient.
22 .LP
23 Notifiers \fBMUST\fR read IPP messages from the standard input using the
24 .BR ippNew ()
25 and
26 .BR ippReadFile ()
27 functions and exit on error.
28 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.
29 Notifiers inherit the environment and can use the logging mechanism documented in
30 .BR filter (7).
31 .SH SEE ALSO
32 .BR cupsd (8),
33 .BR filter (7),
34 CUPS Online Help (http://localhost:631/help)
35 .SH COPYRIGHT
36 Copyright \[co] 2007-2019 by Apple Inc.