Back to index

tor  0.2.3.18-rc
Functions
status.c File Reference

Keep status information and log the heartbeat messages. More...

#include "or.h"
#include "config.h"
#include "status.h"
#include "nodelist.h"
#include "router.h"
#include "circuitlist.h"
#include "main.h"

Go to the source code of this file.

Functions

static int count_circuits (void)
 Return the total number of circuits.
static char * secs_to_uptime (long secs)
 Take seconds secs and return a newly allocated human-readable uptime string.
static char * bytes_to_usage (uint64_t bytes)
 Take bytes and returns a newly allocated human-readable usage string.
int log_heartbeat (time_t now)
 Log a "heartbeat" message describing Tor's status and history so that the user can know that there is indeed a running Tor.

Detailed Description

Keep status information and log the heartbeat messages.

Definition in file status.c.


Function Documentation

static char* bytes_to_usage ( uint64_t  bytes) [static]

Take bytes and returns a newly allocated human-readable usage string.

Definition at line 60 of file status.c.

{
  char *bw_string = NULL;

  if (bytes < (1<<20)) { /* Less than a megabyte. */
    tor_asprintf(&bw_string, U64_FORMAT" kB", U64_PRINTF_ARG(bytes>>10));
  } else if (bytes < (1<<30)) { /* Megabytes. Let's add some precision. */
    double bw = U64_TO_DBL(bytes);
    tor_asprintf(&bw_string, "%.2f MB", bw/(1<<20));
  } else { /* Gigabytes. */
    double bw = U64_TO_DBL(bytes);
    tor_asprintf(&bw_string, "%.2f GB", bw/(1<<30));
  }

  return bw_string;
}

Here is the call graph for this function:

Here is the caller graph for this function:

static int count_circuits ( void  ) [static]

Return the total number of circuits.

Definition at line 19 of file status.c.

{
  circuit_t *circ;
  int nr=0;

  for (circ = _circuit_get_global_list(); circ; circ = circ->next)
    nr++;

  return nr;
}

Here is the call graph for this function:

Here is the caller graph for this function:

int log_heartbeat ( time_t  now)

Log a "heartbeat" message describing Tor's status and history so that the user can know that there is indeed a running Tor.

Return 0 on success and -1 on failure.

Definition at line 81 of file status.c.

{
  char *bw_sent = NULL;
  char *bw_rcvd = NULL;
  char *uptime = NULL;
  const routerinfo_t *me;

  const or_options_t *options = get_options();
  (void)now;

  if (public_server_mode(options)) {
    /* Let's check if we are in the current cached consensus. */
    if (!(me = router_get_my_routerinfo()))
      return -1; /* Something stinks, we won't even attempt this. */
    else
      if (!node_get_by_id(me->cache_info.identity_digest))
        log_fn(LOG_NOTICE, LD_HEARTBEAT, "Heartbeat: It seems like we are not "
               "in the cached consensus.");
  }

  uptime = secs_to_uptime(get_uptime());
  bw_rcvd = bytes_to_usage(get_bytes_read());
  bw_sent = bytes_to_usage(get_bytes_written());

  log_fn(LOG_NOTICE, LD_HEARTBEAT, "Heartbeat: Tor's uptime is %s, with %d "
         "circuits open. I've sent %s and received %s.",
         uptime, count_circuits(),bw_sent,bw_rcvd);

  tor_free(uptime);
  tor_free(bw_sent);
  tor_free(bw_rcvd);

  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

static char* secs_to_uptime ( long  secs) [static]

Take seconds secs and return a newly allocated human-readable uptime string.

Definition at line 33 of file status.c.

{
  long int days = secs / 86400;
  int hours = (int)((secs - (days * 86400)) / 3600);
  int minutes = (int)((secs - (days * 86400) - (hours * 3600)) / 60);
  char *uptime_string = NULL;

  switch (days) {
  case 0:
    tor_asprintf(&uptime_string, "%d:%02d hours", hours, minutes);
    break;
  case 1:
    tor_asprintf(&uptime_string, "%ld day %d:%02d hours",
                 days, hours, minutes);
    break;
  default:
    tor_asprintf(&uptime_string, "%ld days %d:%02d hours",
                 days, hours, minutes);
    break;
  }

  return uptime_string;
}

Here is the call graph for this function:

Here is the caller graph for this function: