notifyutil(1) BSD General Commands Manual notifyutil(1)

NAME
     nnoottiiffyyuuttiill - notification command line utility

SYNOPSIS
     nnoottiiffyyuuttiill [-qq] [-vv] [-tt] [-pp key] [-ww key] [-# key] [-gg key]
                [-ss key val] ...

DESCRIPTION
     nnoottiiffyyuuttiill is a command-line utility for interacting with the notifyd(8)
     notification server.  It may be used to post notifications, detect and
     report notifications, and to examine and set the state value associated
     with a notification key.

     The following table summarizes the actions that may be performed.

           -pp key      Post a notification for key.
           -ww key      Register for key and wait for notifications.
           -# key      Register for key and wait for # (an integer) notifica-
                       tions.  E.g. -11 key waits for a single notification.
           -gg key      Get state value for key.
           -ss key val  Set state value for key.

     When invoked with any combination of -ww and -# actions, nnoottiiffyyuuttiill regis-
     ters for notification for the specified key(s).  If any key is given with
     a -ww action, nnoottiiffyyuuttiill runs until interrupted with Control-C.  If all
     registrations are invoked with -#, the program continues to run until the
     corresponding number of notifications for each key have been received.

     When a notification for any key that is being monitored is received,
     nnoottiiffyyuuttiill prints the key on a single line on its standard output.  The
     -vv (verbose), -tt (time stamp), and -qq (quiet) flags, if specified, modify
     the output behavior.  The -vv flag causes nnoottiiffyyuuttiill to print both the key
     and the current state value for that key.  The -tt flag causes nnoottiiffyyuuttiill
     to print a time stamp preceeding the notification key.  The -qq flag
     causes nnoottiiffyyuuttiill to operate silently.

     nnoottiiffyyuuttiill processes its command-line arguments from left to right.  For
     example, the following will register for a single notification for the
     key ``test.abc'' and then post a notification for that key.

           notifyutil -1 test.abc -p test.abc

SEE ALSO
     notify(3), notifyd(8)

Mac OS X                       September 5, 2006                      Mac OS X