readproctitle

Section: Maintenance Commands (8)
Index Return to Main Contents
 

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-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


 

Index

NAME
SYNOPSIS
DESCRIPTION
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 08:02:03 GMT, September 13, 2024