xref: /NextBSD/usr.sbin/notifyd/notifyd.8 (revision 33da5adc555b3bc29986eeadca03829e4ad06b1e)
1.\" Copyright (c) 2003-2013 Apple Inc. All rights reserved.
2.\"
3.\" @APPLE_LICENSE_HEADER_START@
4.\"
5.\" Portions Copyright (c) 2003-2010 Apple Inc.  All Rights Reserved.
6.\"
7.\" This file contains Original Code and/or Modifications of Original Code
8.\" as defined in and that are subject to the Apple Public Source License
9.\" Version 2.0 (the 'License'). You may not use this file except in
10.\" compliance with the License. Please obtain a copy of the License at
11.\" http://www.opensource.apple.com/apsl/ and read it before using this
12.\" file.
13.\"
14.\" The Original Code and all software distributed under the License are
15.\" distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
16.\" EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
17.\" INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
18.\" FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
19.\" Please see the License for the specific language governing rights and
20.\" limitations under the License.
21.\"
22.\" @APPLE_LICENSE_HEADER_END@
23.\"
24.\"
25.Dd March 24, 2003
26.Dt notifyd 8
27.Os "Mac OS X"
28.Sh NAME
29.Nm notifyd
30.Nd notification server
31.Sh SYNOPSIS
32.Nm
33.Op Fl d
34.Op Fl log_file Ar path
35.Op Fl shm_pages Ar npages
36.Sh DESCRIPTION
37.Nm
38is the server for the Mac OS X notification system described in
39.Xr notify 3 .
40The server is started automatically by
41.Nm launchd
42during system startup.
43.Pp
44The
45.Fl d
46option causes
47.Nm notifyd
48to log debugging messages to a log file.
49Messages are not logged to ASL to avoid potential deadlocks,
50since the ASL system makes use of the
51.Xr notify 3
52system.
53.Pp
54The default log file is
55.Pa /var/log/notifyd.log .
56An alternate log file path may be specified following the
57.Fl log_file
58flag.
59.Pp
60The
61.Fl shm_pages Ar npages
62option sets the number of shared memory pages used for passive notification.
63The default is one page.
64If a value of zero is specified,
65shared memory is disabled and passive notifications are performed
66using IPC between the client and the server.
67.Sh SEE ALSO
68.Xr notify 3 .
69