downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | conferences | my php.net

search for in the

setthreadtitle> <Proctitle Functions
[edit] Last updated: Fri, 26 Apr 2013

view this page in

setproctitle

(PECL proctitle >= 0.1.0)

setproctitleSet the process title

Description

void setproctitle ( string $title )

Sets the process title of the current process.

Parameters

title

The title to use as the process title.

Return Values

No value is returned.

Examples

Example #1 setproctitle() example

Running the example below will change the process title (visible with ps a for example).

<?php
setproctitle
("myscript");
?>

The above example will output something similar to:

$ ps a
  PID TTY      STAT   TIME COMMAND
 1168 pts/3    S      0:00 myscript                                                                                                                         

See Also



add a note add a note User Contributed Notes setproctitle - [1 notes]
up
0
zodbd421 at gmail dot com
11 days ago
Note that this extension is considered buggy.  See https://wiki.php.net/rfc/cli_process_title, which says:

"...but it is incomplete and might lead to memory corruption on Linux (or any OS which does not support setproctitle.

The reason is the extension only has access to original argv[0] (that comes from main()). argv and environ(7) are in contiguous memory space on Linux. The extension presumes that argv[0] can accomodate 128 characters, but usually that is not possible because argv[0] is “php”. When this happens, the extension will scribble on argv[1], argv[2], etc., and maybe even environ and this can have destructive side effects on the running program."

 
show source | credits | stats | sitemap | contact | advertising | mirror sites