Data Fields
or_state_t Struct Reference

#include <or_state_st.h>

Data Fields

uint32_t magic_
time_t next_write
time_t LastWritten
time_t AccountingIntervalStart
uint64_t AccountingBytesReadInInterval
uint64_t AccountingBytesWrittenInInterval
int AccountingSecondsActive
int AccountingSecondsToReachSoftLimit
time_t AccountingSoftLimitHitAt
uint64_t AccountingBytesAtSoftLimit
uint64_t AccountingExpectedUsage
struct config_line_tGuard
struct config_line_tTransportProxies
time_t BWHistoryReadEnds
int BWHistoryReadInterval
struct smartlist_tBWHistoryReadValues
struct smartlist_tBWHistoryReadMaxima
time_t BWHistoryWriteEnds
int BWHistoryWriteInterval
struct smartlist_tBWHistoryWriteValues
struct smartlist_tBWHistoryWriteMaxima
time_t BWHistoryIPv6ReadEnds
int BWHistoryIPv6ReadInterval
struct smartlist_tBWHistoryIPv6ReadValues
struct smartlist_tBWHistoryIPv6ReadMaxima
time_t BWHistoryIPv6WriteEnds
int BWHistoryIPv6WriteInterval
struct smartlist_tBWHistoryIPv6WriteValues
struct smartlist_tBWHistoryIPv6WriteMaxima
time_t BWHistoryDirReadEnds
int BWHistoryDirReadInterval
struct smartlist_tBWHistoryDirReadValues
struct smartlist_tBWHistoryDirReadMaxima
time_t BWHistoryDirWriteEnds
int BWHistoryDirWriteInterval
struct smartlist_tBWHistoryDirWriteValues
struct smartlist_tBWHistoryDirWriteMaxima
struct config_line_tBuildtimeHistogram
int TotalBuildTimes
int CircuitBuildAbandonedCount
char * TorVersion
struct config_line_tExtraLines
time_t LastRotatedOnionKey
struct config_suite_tsubstates_

Detailed Description

Persistent state for an onion router, as saved to disk.

Definition at line 21 of file or_state_st.h.

Field Documentation

◆ AccountingIntervalStart

time_t AccountingIntervalStart

Fields for accounting bandwidth use.

Definition at line 32 of file or_state_st.h.

Referenced by accounting_record_bandwidth_usage().

◆ BuildtimeHistogram

struct config_line_t* BuildtimeHistogram

Build time histogram

Definition at line 80 of file or_state_st.h.

◆ BWHistoryReadEnds

time_t BWHistoryReadEnds

These fields hold information on the history of bandwidth usage for servers. The "Ends" fields hold the time when we last updated the bandwidth usage. The "Interval" fields hold the granularity, in seconds, of the entries of Values. The "Values" lists hold decimal string representations of the number of bytes read or written in each interval. The "Maxima" list holds decimal strings describing the highest rate achieved during the interval.

Definition at line 54 of file or_state_st.h.

◆ ExtraLines

struct config_line_t* ExtraLines

Holds any unrecognized values we found in the state file, in the order in which we found them.

Definition at line 89 of file or_state_st.h.

◆ Guard

struct config_line_t* Guard

A list of guard-related configuration lines.

Definition at line 42 of file or_state_st.h.

Referenced by entry_guards_load_guards_from_state().

◆ LastRotatedOnionKey

time_t LastRotatedOnionKey

When did we last rotate our onion key? "0" for 'no idea'.

Definition at line 92 of file or_state_st.h.

◆ LastWritten

time_t LastWritten

When was the state last written to disk?

Definition at line 29 of file or_state_st.h.

◆ next_write

time_t next_write

The time at which we next plan to write the state to the disk. Equal to TIME_MAX if there are no saveable changes, 0 if there are changes that should be saved right away.

Definition at line 26 of file or_state_st.h.

Referenced by or_state_mark_dirty(), and save_state_callback().

◆ substates_

struct config_suite_t* substates_

State objects for individual modules.

Never access this field or its members directly: instead, use the module in question to get its relevant state object if you must.

Definition at line 100 of file or_state_st.h.

◆ TorVersion

char* TorVersion

What version of Tor wrote this state file?

Definition at line 85 of file or_state_st.h.

The documentation for this struct was generated from the following file: