| Index: base/setproctitle_linux.c
 | 
| ===================================================================
 | 
| --- base/setproctitle_linux.c	(revision 0)
 | 
| +++ base/setproctitle_linux.c	(revision 0)
 | 
| @@ -0,0 +1,112 @@
 | 
| +// Copyright (c) 2009 The Chromium Authors. All rights reserved.
 | 
| +// Use of this source code is governed by a BSD-style license that can be
 | 
| +// found in the LICENSE file.
 | 
| +
 | 
| +// This file implements BSD-style setproctitle() for Linux.
 | 
| +// It is written such that it can easily be compiled outside Chromium.
 | 
| +//
 | 
| +// The Linux kernel sets up two locations in memory to pass arguments and
 | 
| +// environment variables to processes. First, there are two char* arrays stored
 | 
| +// one after another: argv and environ. A pointer to argv is passed to main(),
 | 
| +// while glibc sets the global variable |environ| to point at the latter. Both
 | 
| +// of these arrays are terminated by a NULL pointer; the environment array is
 | 
| +// also followed by some empty space to allow additional variables to be added.
 | 
| +//
 | 
| +// These arrays contain pointers to a second location in memory, where the
 | 
| +// strings themselves are stored one after another: first all the arguments,
 | 
| +// then the environment variables. The kernel will allocate a single page of
 | 
| +// memory for this purpose, so the end of the page containing argv[0] is the
 | 
| +// end of the storage potentially available to store the process title.
 | 
| +//
 | 
| +// When the kernel reads the command line arguments for a process, it looks at
 | 
| +// the range of memory within this page that it initially used for the argument
 | 
| +// list. If the terminating '\0' character is still where it expects, nothing
 | 
| +// further is done. If it has been overwritten, the kernel will scan up to the
 | 
| +// size of a page looking for another. (Note, however, that in general not that
 | 
| +// much space is actually mapped, since argv[0] is rarely page-aligned and only
 | 
| +// one page is mapped.)
 | 
| +//
 | 
| +// Thus to change the process title, we must move any environment variables out
 | 
| +// of the way to make room for a potentially longer title, and then overwrite
 | 
| +// the memory pointed to by argv[0] with a single replacement string, making
 | 
| +// sure its size does not exceed the available space.
 | 
| +//
 | 
| +// It is perhaps worth noting that patches to add a system call to Linux for
 | 
| +// this, like in BSD, have never made it in: this is the "official" way to do
 | 
| +// this on Linux. Presumably it is not in glibc due to some disagreement over
 | 
| +// this position within the glibc project, leaving applications caught in the
 | 
| +// middle. (Also, only a very few applications need or want this anyway.)
 | 
| +
 | 
| +#include "base/setproctitle_linux.h"
 | 
| +
 | 
| +#include <stdarg.h>
 | 
| +#include <stdint.h>
 | 
| +#include <stdio.h>
 | 
| +#include <string.h>
 | 
| +#include <unistd.h>
 | 
| +
 | 
| +extern char** environ;
 | 
| +
 | 
| +static char** g_main_argv = NULL;
 | 
| +static char* g_orig_argv0 = NULL;
 | 
| +
 | 
| +void setproctitle(const char* fmt, ...) {
 | 
| +  va_list ap;
 | 
| +  size_t i, avail_size;
 | 
| +  uintptr_t page_size, page, page_end;
 | 
| +  // Sanity check before we try and set the process title.
 | 
| +  // The BSD version allows fmt == NULL to restore the original title.
 | 
| +  if (!g_main_argv || !environ || !fmt)
 | 
| +    return;
 | 
| +  if (!g_orig_argv0) {
 | 
| +    // Save the original argv[0].
 | 
| +    g_orig_argv0 = strdup(g_main_argv[0]);
 | 
| +    if (!g_orig_argv0)
 | 
| +      return;
 | 
| +  }
 | 
| +  page_size = sysconf(_SC_PAGESIZE);
 | 
| +  // Get the page on which the argument list and environment live.
 | 
| +  page = (uintptr_t) g_main_argv[0];
 | 
| +  page -= page % page_size;
 | 
| +  page_end = page + page_size;
 | 
| +  // Move the environment out of the way. Note that we are moving the values,
 | 
| +  // not the environment array itself (which may not be on the page we need
 | 
| +  // to overwrite anyway).
 | 
| +  for (i = 0; environ[i]; ++i) {
 | 
| +    uintptr_t env_i = (uintptr_t) environ[i];
 | 
| +    // Only move the value if it's actually in the way. This avoids
 | 
| +    // leaking copies of the values if this function is called again.
 | 
| +    if (page <= env_i && env_i < page_end) {
 | 
| +      char* copy = strdup(environ[i]);
 | 
| +      // Be paranoid. Check for allocation failure and bail out.
 | 
| +      if (!copy)
 | 
| +        return;
 | 
| +      environ[i] = copy;
 | 
| +    }
 | 
| +  }
 | 
| +  // Put the title in argv[0]. We have to zero out the space first since the
 | 
| +  // kernel doesn't actually look for a null terminator unless we make the
 | 
| +  // argument list longer than it started.
 | 
| +  avail_size = page_end - (uintptr_t) g_main_argv[0];
 | 
| +  memset(g_main_argv[0], 0, avail_size);
 | 
| +  va_start(ap, fmt);
 | 
| +  if (fmt[0] == '-') {
 | 
| +    vsnprintf(g_main_argv[0], avail_size, fmt, ap);
 | 
| +  } else {
 | 
| +    size_t size = snprintf(g_main_argv[0], avail_size, "%s ", g_orig_argv0);
 | 
| +    if (size < avail_size)
 | 
| +      vsnprintf(g_main_argv[0] + size, avail_size - size, fmt, ap);
 | 
| +  }
 | 
| +  va_end(ap);
 | 
| +  g_main_argv[1] = NULL;
 | 
| +}
 | 
| +
 | 
| +// A version of this built into glibc would not need this function, since
 | 
| +// it could stash the argv pointer in __libc_start_main(). But we need it.
 | 
| +void setproctitle_init(char** main_argv) {
 | 
| +  uintptr_t page_size = sysconf(_SC_PAGESIZE);
 | 
| +  // Check that the argv array is in fact on the same page of memory
 | 
| +  // as the environment array just as an added measure of protection.
 | 
| +  if (((uintptr_t) environ) / page_size == ((uintptr_t) main_argv) / page_size)
 | 
| +    g_main_argv = main_argv;
 | 
| +}
 | 
| 
 | 
| Property changes on: base/setproctitle_linux.c
 | 
| ___________________________________________________________________
 | 
| Added: svn:eol-style
 | 
|    + LF
 | 
| 
 | 
| 
 |