DragonFly On-Line Manual Pages

readproctitle(8)       DragonFly System Manager's Manual      readproctitle(8)

NAME
       readproctitle - maintains an automatically rotated log in memory for
       inspection by ps(1).

       readproctitle is available in daemontools 0.75 and above.

SYNOPSIS
       readproctitle L D

DESCRIPTION
       L consists of any number of arguments.  D is one argument consisting of
       at least five dots.

       readproctitle reads data into the end of D, shifting D to the left to
       make room. This means that the most recent data is visible to process-
       listing tools such as ps(1).  readproctitle always leaves three dots at
       the left of D.

       For example, if

        readproctitle io errors: ....................

       reads the data

        fatal error xyz
        warning abc

       then its command-line arguments change to

        readproctitle io errors: ... xyz!warning abc!

       where each ! is a newline character. Process-listing tools typically
       show the newline character as ? or \n.

       readproctitle exits when it reaches the end of input.

       Beware that most implementations of ps(1) have small argument-length
       limits. These limits apply to the total length of readproctitle L D.  I
       have not seen a system with a limit below 512 bytes.

SEE ALSO
       supervise(8), svc(8), svok(8), svstat(8), svscanboot(8), svscan(8),
       fghack(8), pgrphack(8), multilog(8), tai64n(8), tai64nlocal(8),
       setuidgid(8), envuidgid(8), envdir(8), softlimit(8), setlock(8), ps(1)

        http://cr.yp.to/daemontools.html
        http://cr.yp.to/slashcommand.html

                                                              readproctitle(8)