Implementation of an API to set process title. More...

#include "proctitle.h"
#include <glib.h>
#include <stdio.h>
#include <string.h>
#include <sys/param.h>
#include <sys/prctl.h>

Include dependency graph for proctitle.c:

Go to the source code of this file.

Macros
#define	G_LOG_DOMAIN "libgvm base"
	GLib log domain.

Functions
void	proctitle_init (int argc, char **argv)
	Initializes the process setting variables.
static void	proctitle_set_args (const char *new_title, va_list args)
	Sets the process' title.
void	proctitle_set (const char *new_title,...)
	Sets the process' title.

Variables
const char *	__progname
	Access to the executable's name.
const char *	__progname_full
static char **	old_argv
static int	old_argc
char **	environ
void *	current_environ = NULL
static int	max_prog_name = 0

Detailed Description

Implementation of an API to set process title.

Definition in file proctitle.c.

Macro Definition Documentation

◆ G_LOG_DOMAIN

#define G_LOG_DOMAIN "libgvm base"

GLib log domain.

Definition at line 23 of file proctitle.c.

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:

◆ proctitle_set_args()

void proctitle_set_args	(	const char *	new_title,
		va_list	args )

static

Sets the process' title.

Parameters

[in]	new_title	Format string for new process title.
[in]	args	Format string arguments variable list.

Definition at line 102 of file proctitle.c.

{
  char *formatted;
  int tmp;
 
  if (old_argv == NULL)
    /* Called setproctitle before initproctitle ? */
    return;
  if (max_prog_name == 0)
    // there may no program name set
    return;
  // omit previous additional parameter
 
  formatted = g_strdup_vprintf (new_title, args);
 
  tmp = strlen (formatted);
  if (tmp >= max_prog_name)
    {
      formatted[max_prog_name] = '\0';
      tmp = max_prog_name;
    }
 
  // set display name
  memset (old_argv[0], 0, max_prog_name);
  memcpy (old_argv[0], formatted, tmp);
  g_free (formatted);
  if (old_argc > 1)
    old_argv[1] = NULL;
}