proctitle.h File Reference

API for process title setting. More...

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
void	proctitle_init (int, char **)
	Initializes the process setting variables. More...
void	proctitle_set (const char *,...)
	Sets the process' title. More...

Detailed Description

API for process title setting.

Definition in file proctitle.h.

Function Documentation

proctitle_init()

void proctitle_init	(	int	argc,
		char **	argv
	)

Initializes the process setting variables.

Parameters

[in]	argc	Argc argument from main.
[in]	argv	Argv argument from main.

Definition at line 45 of file proctitle.c.

{
  int i;
  char **envp = environ;
#ifndef __FreeBSD__
  char *new_progname, *new_progname_full;
#else
  char *new_progname;
#endif
  old_argc = argc;
 
  if (argv == NULL)
    return;
  // according to c99 argv is defined as when argc is set it follows program
  // parameter. Since we will override on set_proctitle we know that this
  // memory is modifiable.
  // Everything after that is unsafe and can lead to segmentation faults.
  // Therefore we iterate through argv and append strlen to gather the maximum
  // safe program name.
  for (i = 0; i < argc; i++)
    {
      max_prog_name += strlen (argv[i]) + 1;
    }
  i = 0;
 
  new_progname = strdup (__progname);
#ifndef __FreeBSD__
  new_progname_full = strdup (__progname_full);
#endif
 
  /* Move environ to new memory, to be able to reuse older one. */
  while (envp[i])
    i++;
  environ = g_malloc0 (sizeof (char *) * (i + 1));
  if (current_environ)
    g_free (current_environ);
  current_environ = environ;
  for (i = 0; envp[i]; i++)
    environ[i] = g_strdup (envp[i]);
  environ[i] = NULL;
 
  old_argv = argv;
  /* Seems like these are in the moved environment, so reset them.  Idea from
   * proctitle.cpp in KDE libs.  */
  __progname = new_progname;
#ifndef __FreeBSD__
  __progname_full = new_progname_full;
#endif
}

References __progname, __progname_full, current_environ, environ, max_prog_name, old_argc, and old_argv.

proctitle_set()

void proctitle_set	(	const char *	new_title,
			...
	)

Sets the process' title.

Parameters

[in]	new_title	Format string for new process title.
[in]	...	Arguments for format string.

Definition at line 139 of file proctitle.c.

{
  va_list args;
 
  va_start (args, new_title);
  proctitle_set_args (new_title, args);
  va_end (args);
}

References proctitle_set_args().

Here is the call graph for this function: