readproctitle(8)                                 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!

       with a newline character in place of each !. Process-list-
       ing 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 argu-
       ment-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








                                                                1