Skip to content

notify daemon.8

Manvendra Bhangui edited this page Jan 17, 2025 · 1 revision

NAME

notify-daemon - Daemon for controlling LCD Displays with Hitachi 44780 controller

SYNOPSYS

notify-daemon [-v] [-f fifo] [-m mode]

  [-t readtimeout] [-p port]
  [-i startup_message] [-s shutdown_message]

DESCRIPTION

notify-daemon(8) reads a named pipe fifo or listens on a UDP socket to read messages from clients to be printed as desktop notification using notify-send(1). notify-daemon(8) creates the directory for the named pipe fifo, if it doesn't exist. The file mode for fifo can be provided by mode.

notify-daemon(8) is generally started through supervise(8) using /service/notify-desktop service. You can however use your own method to start notify-daemon(8).

By default, notify-daemon(8) creates rundir/notify-desktop/notify-fifo named pipe and listens on UDP port 1807.

You can use nc(1) command or any TCP applciation to write a message to the UDP port 1807. You can use any any client that writes to the named pipe rundir/notify-desktop/notify-fifo, created by notify-daemon(8).

Any client has to write the message by following format below (<sp> stands for the white space character).

rownum<sp>scroll<sp>clear:message

where

rownum
value can be 0 or 1 for 16x2 display or 0, 1, 2 or 3 for 20x4 display. This is used by lcd-daemon(8) but ignored by notify-daemon(8).

scroll
value can be 0 or 1. 1 turns on scrolling. This is used by lcd-daemon(8) but ignored by notify-daemon(8).

clear
The following values are supported for clear

1 clear the screen
2 clear and initialize
3 initializing LCD display
4 clear screen without displaying text
5 clear and initialize screen without displaying text
6 initialize screen without displaying text

This is used by lcd-daemon(8) but ignored by notify-daemon(8).

message
Here message is any string consisting of one or more words.

OPTIONS

-v
Turn on verbose output

-f fifo
Path to fifo

-m mode
File mode to set for fifo on startup.

-p port
UDP port on which notify-daemon(8) listens. If not provided this is 1807.

-t readtimeout
No of milliseconds notify-daemon(8) will read a message from a client before timing out. Default is 300 milliseconds.

-i startup_msg
Startup message to be displayed on LCD on notify-daemon(8) startup

-s shutdown_msg
Shutdown message to be displayed on LCD on notify-daemon(8) startup

Environment Variables

notify-daemon(8)(8) uses the following environment variables.

NOTIFYFIFO
If the -f option is not provided, notify-daemon(8) reads rundir/notify-desktop/notify-fifo, where rundir is /run, /var/run or /tmp depending on your system. The fifo can be changed by setting NOTIFYFIFO environment variable.

FIFO_MODE
if the -m option is not provided, notify-daemon(8) sets 0666 as the file mode for fifo. The mode can be changed by setting FIFO_MODE environment variable.

VERBOSE
If -v option is not provided the value of VERBOSE environment is used. Setting VERBOSE=1 turns on verbose output and VERBOSE=0 turns of verbose output.

DATA_TIMEOUT
If -t is not provided, the env variable DATA_TIMEOUT is used. This is timeout in seconds after which notify-daemon(8) will timeout when reading from the named pipe or from the socket. Default is 300 seconds.

PORT
If -p is not provided, the env variable PORT is used. This is the UDP port on which notify-daemon(8) listens for UDP packets. Default port is 1807.

RETURN VALUE

0 if all steps were successful, non-zero otherwise. If any of the steps fail, a diagnostic message is printed. If any systerm error is encountered, the return value will be 111.

AUTHORS

Manvendra Bhangui <[email protected]>

SEE ALSO

supervise(8) svc(8) envdir(8) multilog(8) lcd-daemon(8),

Clone this wiki locally