sastatd.c-Dateireferenz

Statistikdaemon fuer Skill-Attribute Der Daemon loggt SA-Modifier und schreibt sie von Zeit zu Zeit auf die Platte. Mehr ...

#include <defines.h>

Include-Abhängigkeitsdiagramm für sastatd.c:

gehe zum Quellcode dieser Datei

Klassen
struct	log_entry_s
struct	log_buffer_s
Makrodefinitionen
#define	DEFAULT_BUFFER_LEN   200
	anfaengliche Groesse des Log-Puffers
#define	BUFFERTHRESHOLD   150
	ab dieser Anzahl an Eintraegen wird im naechsten Backend-Zyklus vom Driver per Callout der Puffer weggeschrieben.
#define	STATLOG   "SASTATS"
	Logfile fuer die Stats.
#define	MAXLOGSIZE   3145728
	max.
#define	DEBUG(x)
	Outputs debug message to Maintainer, if Mainteiner is logged in.
Funktionen
private string	FormatLogEntry (struct log_entry_s entry)
private void	WriteBuffer ()
public void	LogModifier (object caster, string atrname, mixed value, int duration)
protected void	create ()
varargs public int	remove (int silent)
void	reset ()
Variablen
struct log_buffer_s	logbuf
	speichert Logeintraege mit indiv.

---

Ausführliche Beschreibung

Statistikdaemon fuer Skill-Attribute Der Daemon loggt SA-Modifier und schreibt sie von Zeit zu Zeit auf die Platte.

Autor:

Zesstra

Datum:

06.08.2008

Version:

$Id$

Definiert in Datei sastatd.c.

---

Makro-Dokumentation

#define BUFFERTHRESHOLD   150

ab dieser Anzahl an Eintraegen wird im naechsten Backend-Zyklus vom Driver per Callout der Puffer weggeschrieben.

Definiert in Zeile 23 der Datei sastatd.c.

#define DEBUG

(

x

)

Wert:

if (find_player("zesstra"))\
            tell_object(find_player("zesstra"),\
                                      "EDBG: "+x+"\n")

Outputs debug message to Maintainer, if Mainteiner is logged in.

Definiert in Zeile 62 der Datei sastatd.c.

#define DEFAULT_BUFFER_LEN   200

anfaengliche Groesse des Log-Puffers

Definiert in Zeile 20 der Datei sastatd.c.

#define MAXLOGSIZE   3145728

max.

Logfilegroesse (3 MB)

Definiert in Zeile 30 der Datei sastatd.c.

#define STATLOG   "SASTATS"

Logfile fuer die Stats.

Definiert in Zeile 27 der Datei sastatd.c.

---

Dokumentation der Funktionen

protected void create

(

)

Definiert in Zeile 113 der Datei sastatd.c.

                        {
  seteuid(getuid(ME));
}

private string FormatLogEntry

(

struct log_entry_s

entry

)

Definiert in Zeile 67 der Datei sastatd.c.

Benutzt log_entry_s::atrname, log_entry_s::caster, log_entry_s::duration, log_entry_s::liv, strftime(), log_entry_s::timestamp und log_entry_s::value.

                                                        {
  return sprintf("[%s] %s, %s, %s, %s, %d\n", 
      strftime("%d%m%y-%H%M%S",entry->timestamp),
      entry->liv, entry->caster, entry->atrname,
      entry->value, entry->duration);
}

Hier ist ein Graph der zeigt, was diese Funktion aufruft:

public void LogModifier	(	object	caster,
		string	atrname,
		mixed	value,
		int	duration
	)

Definiert in Zeile 85 der Datei sastatd.c.

                                                   {
  // nur Spieler sind interessant
  if (!query_once_interactive(previous_object()))
    return;

  // sp um eins erhoehen und schauen, ob die Puffergroesse ueberschritten
  // wurde. Wenn ja, Puffer vergroessern.
  logbuf->sp++;
  if (logbuf->sp >= logbuf->bufferlen) {
    logbuf->buf = logbuf->buf + allocate(50);
    logbuf->bufferlen += 50;
  }
  // eintragen. Interessanterweise ist es tatsaechlich kein Problem, wenn
  // Structmember und lokale Variablen hier den gleichen Namen habem. ;-)
  logbuf->buf[logbuf->sp] = (<log_entry_s>
      timestamp : time(),
      liv : getuid(previous_object()), // nur Spieler
      caster : object_name(caster),
      atrname : atrname,
      value : to_string(value), // wegen (fluechtiger) Closures
      duration : duration );
  // wegschreiben veranlassen
  if (logbuf->sp > BUFFERTHRESHOLD
      && find_call_out(#'WriteBuffer) == -1)
    call_out(#'WriteBuffer, 0);
}

varargs public int remove

(

int

silent

)

Definiert in Zeile 117 der Datei sastatd.c.

                                      {
  if (logbuf->sp > -1)
    WriteBuffer();
  destruct(ME);
  return 1;
}

void reset

(

void

)

Definiert in Zeile 124 der Datei sastatd.c.

             {
  // ggf. Puffer wegschreiben.
  if (logbuf->sp > BUFFERTHRESHOLD)
    WriteBuffer();
  // ggf. sehr grosse Puffer verkleinern
  if (logbuf->bufferlen > DEFAULT_BUFFER_LEN * 2) {
    logbuf->buf = allocate(DEFAULT_BUFFER_LEN);
    logbuf->bufferlen = DEFAULT_BUFFER_LEN;
    logbuf->sp = -1;
  }
}

private void WriteBuffer

(

)

Definiert in Zeile 74 der Datei sastatd.c.

Benutzt log_buffer_s::buf, buf und log_buffer_s::sp.

                           {
  // relevanten Teil des Puffers extrahieren.
  mixed buf = logbuf->buf[0..logbuf->sp];
  // dann alle Eintraege in Strings mappen
  buf = map(buf, #'FormatLogEntry);
  // wegschreiben
  log_file(STATLOG, sprintf("%@s",buf), MAXLOGSIZE);
  // sp auf den Pufferanfang setzen
  logbuf->sp = -1;
}

---

Variablen-Dokumentation

struct log_buffer_s logbuf

Initialisierung:

 (<log_buffer_s>
    buf : allocate(DEFAULT_BUFFER_LEN),
    bufferlen : DEFAULT_BUFFER_LEN,
    
    
    sp : -1 )

speichert Logeintraege mit indiv.

Modifiereintraegen. Array von log_entry_s mit Info ueber Pufferlaenge und zuletzt geschriebenem Arrayeintrag.

Definiert in Zeile 51 der Datei sastatd.c.