memory.c-Dateireferenz

#include <config.h>
#include <wizlevels.h>
#include <files.h>

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

gehe zum Quellcode dieser Datei

Funktionen
void	create ()
int	Save (string key, mixed data)
mixed	Load (string key)
int	Remove (string key)
int	HaveRights ()
varargs int	RereadProgramLists (int silent)
void	ShowData ()
private string	allowed ()
private string	get_caller_hash ()
private mixed	read_list (string file)
private mapping	get_memory_pointer ()
varargs void	ShowData (int verbose)
Variablen
string *	known_programs
	Liste mit Programmen, die den Memory nutzen duerfen Die Variable wird entweder im create() oder durch manuellen Aufruf von RereadProgramLists() aus /secure/memory_lib und /secure/memory_nolib befuellt.

---

Dokumentation der Funktionen

private string allowed

(

)

Definiert in Zeile 80 der Datei scoremaster.c.

Benutzt ARCH_SECURITY, IS_ARCH, process_call() und ROOTID.

{
  if (previous_object() && geteuid(previous_object())==ROOTID)
    return 1;
  if (!process_call() && previous_object() && this_interactive() && ARCH_SECURITY)
    return 1;
  return 0;
}

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

void create

(

)

Objekt initialisieren

Definiert in Zeile 63 der Datei memory.c.

Benutzt info, MEMORY_BUFF und RereadProgramLists().

              {
  mapping info;
  seteuid(getuid(this_object()));

  // Wizinfo-Pointer holen
  if(!pointerp(info=get_extra_wizinfo(0)))
    raise_error("WIZINFO nicht lesbar. secure/simul_efun muss neu geladen werden.!\n");

  // Mein Feld der Wizinfo bei Bedarf initialisieren
  if(!mappingp(info[MEMORY_BUFF]))
    info[MEMORY_BUFF]=([]);

  RereadProgramLists(1);
}

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

private string get_caller_hash

(

)

Wenn das aufrufende Programm fuer die Speichernutzung zugelassen ist, wird hier der Hash zurueckgegeben unter dem seine Daten abgespeichert sind. Der Hash ist derzeit der Filename des Blueprint.

Definiert in Zeile 83 der Datei memory.c.

Benutzt known_programs.

Wird benutzt von HaveRights(), Load(), Remove() und Save().

                                 {
  if (member(known_programs, program_name(previous_object())[..<3]) != -1) 
    return program_name(previous_object())[..<3];
  else 
    return 0;
}

Hier ist ein Graph der zeigt, wo diese Funktion aufgerufen wird:

private mapping get_memory_pointer

(

)

Zeiger auf den Speicher holen

Definiert in Zeile 133 der Datei memory.c.

Benutzt info und MEMORY_BUFF.

Wird benutzt von Load(), Remove(), Save() und ShowData().

                                    {
  mixed info;

  // Die Fehlermeldungen sind etwas ausfuehrlicher, um dem Debugger
  // einen Hinweis auf Reparaturmoeglichkeiten zu geben
  if(!pointerp(info=get_extra_wizinfo(0)))
    raise_error("Wizinfo nicht ladbar. Entweder ich hab keine Rechte "
                "oder das Mud hat ein echtes Problem!\n");

  if(!mappingp(info[MEMORY_BUFF]))
    raise_error("Ich finde meine Daten in der Wizinfo nicht. Ein EM kann "
                "versuchen, mich neu zu laden, aber was die alten Daten "
                "betrifft, frei nach Catty: Keine Arme, keine Kekse!\n");
  // Da info[MEMORY_BUFF] immer ein Mapping ist (siehe Create), wird hier ein 
  // Pointer uebergeben. Dadurch werden Details zum Aufbau der extra_wizinfo
  // nur in dieser Funktion benoetigt.
  return info[MEMORY_BUFF]; 
}

Hier ist ein Graph der zeigt, wo diese Funktion aufgerufen wird:

int HaveRights

(

)

Pruefen, ob previous_object() Nutzungsrechte fuer den Memory hat.

Rückgabe:

Gibt 1 zurueck, wenn der Aufrufende berechtigt ist, das Objekt zu nutzen, sonst 0

Definiert in Zeile 157 der Datei memory.c.

Benutzt get_caller_hash().

                {
  return stringp(get_caller_hash());
}

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

mixed Load

(

string

key

)

Daten ausgeben/referenzieren

Parameter:

key

Id unter der die Daten gespeichert sind.

Definiert in Zeile 202 der Datei memory.c.

Benutzt get_caller_hash(), get_memory_pointer(), memory und who.

                       {
  string who;
  mapping memory;

  // Hash des Aufrufers holen. Hat der keinen, ist er nicht befugt,
  // den Memory zu nutzen.
  if(!stringp(who=get_caller_hash())) return 0;

  // Wenn kein Key uebergeben wird, kann auch nichts gespeichert werden.
  if(!stringp(key)) return 0;

  // (hoffentlich) globalen memory_pointer holen
  memory = get_memory_pointer();

  // Das Objekt hat noch nie Save() aufgerufen.
  if(!member(memory,who))
    return 0;

  // Unter diesem Key ist noch nichts gespeichert.
  if(!member(memory[who],key))
    return 0;

  // Gespeicherten Wert zurueckgeben
  return memory[who][key];
}

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

private mixed read_list

(

string

file

)

Die Hilfsfunktion liest eine Liste mit Dateinamen und gibt die Programme als Array of Strings zurueck. Alle Zeilen die nicht mit einem Slash anfangen, werden dabei ignoriert.

Parameter:

file

Die auszulesende Datei.

Definiert in Zeile 96 der Datei memory.c.

Benutzt data, FSIZE_NOFILE und x.

Wird benutzt von RereadProgramLists().

{
  mixed data;
  if (!stringp(file) || file_size(file) == FSIZE_NOFILE )
    return ({});

  // Daten laden
  data = explode(read_file(file)||"", "\n");

  // Alle Zeilen die nicht mit / beginnen entfernen ...
  data=regexp(data,"^/.+");

  // ".c" und eventuelle Leerzeichen in jeder Zeile werden entfernt
  data= map(data, 
     function string (string x) {return regreplace(x,"(.c)* *$","",1);});
  return data;
}

Hier ist ein Graph der zeigt, wo diese Funktion aufgerufen wird:

varargs int Remove

(

string

key

)

Ein Eintrag oder alle Eintraege werden geloescht

Parameter:

key

Id unter der die Daten gespeichert sind. Wird kein Key uebergeben, werden alle Daten des Objekts geloescht.

Definiert in Zeile 234 der Datei memory.c.

Benutzt get_caller_hash(), get_memory_pointer(), m_delete(), memory und who.

                               {
  string who;
  mapping memory;

  // Hash des Aufrufers holen. Hat der keinen, ist er nicht befugt,
  // den Memory zu nutzen.
  if(!stringp(who=get_caller_hash())) return 0;

  // (hoffentlich) globalen memory_pointer holen
  memory = get_memory_pointer();

  // Das Objekt hat noch nie Save() aufgerufen.
  if(!member(memory,who)) return 0;

  // Wenn kein Key uebergeben wird, wird alles zum Objekt gehoerende geloescht.
  if(stringp(key)){
    // Unter diesem Key ist nichts gespeichert.
    if(!member(memory[who],key)) return 0;

    // Wert unter Key fuer das File loeschen
    efun::m_delete(memory[who], key);

  } else {
    // Alles fuer das File loeschen
    efun::m_delete(memory, who);
  }

  return 1; 
}

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

varargs int RereadProgramLists

(

int

silent

)

Wenn die Liste mit Programmen geaendert wurde, kann sie hier per Hand neu eingelesen werden.

Parameter:

silent

Varargs Flag, um Bildschirmausgabe zu unterdruecken

Definiert in Zeile 119 der Datei memory.c.

Benutzt known_programs und read_list().

Wird benutzt von create().

{
  // Objekte laden, die zur Mudlib gehoeren
  known_programs = read_list("/secure/memory_lib");

  // Objekte laden, die nicht zur Mudlib gehoeren
  known_programs+=read_list("/secure/memory_nolib");

  if(!silent) printf ("%O\n", known_programs);

  return sizeof(known_programs);
}

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

Hier ist ein Graph der zeigt, wo diese Funktion aufgerufen wird:

int Save	(	string	key,
		mixed	var
	)

Daten im Memory ablegen

Parameter:

	key	ID unter der die Daten gespeichert werden
	var	Zu speicherndes Datum

Definiert in Zeile 166 der Datei memory.c.

Benutzt get_caller_hash(), get_memory_pointer(), memory und who.

                                {
  string who;
  mapping memory;

  // Hash des Aufrufers holen. Hat der keinen, ist er nicht befugt,
  // den Memory zu nutzen.
  if(!stringp(who=get_caller_hash())) return 0;

  // Wenn kein Key uebergeben wird, kann auch nichts gespeichert werden.
  if(!stringp(key)) return 0;

  // (hoffentlich) globalen memory_pointer holen
  memory = get_memory_pointer();

  // Wenn keine Daten da sind, muss man auch nichts anlegen. Rueckgabewert
  // ist dennoch 1, weil Load bei unbekannten Keys auch 0 liefert, die 
  // Null wird also korrekt gespeichert, irgendwie. Das muss aber nach dem
  // get_memory_pointer() passieren, da sonst das Korrekte Funktionieren von
  // Load nicht sichergestellt ist.
  if(var==0) return 1;

  // Erster Aufruf durch PO? Dann muss sein Speicherbereich initialisiert 
  // werden
  if(!member(memory,who))
    memory[who]=([]);

  // Endlich! Daten koennen gespeichert werden.
  memory[who][key]=var;

  return 1;
}

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

varargs void ShowData

(

int

verbose

)

Definiert in Zeile 264 der Datei memory.c.

Benutzt ARCH_SECURITY, break_string(), data, ELDER_SECURITY, get_memory_pointer(), known_programs, memory und program.

                                  {
  // Bekannte Objekte
  if (!ELDER_SECURITY )
    printf("I'm fine. Thanks for asking.\n");
  else {
    printf("known_programs:\n%O\n\n", known_programs);
    // EM duerfen sich auch noch zuscrollen lassen, wenn sie wollen
    if (ARCH_SECURITY && verbose)
      printf("memory: (Verbose)\n%O\n", get_memory_pointer()); 
    else {
      mapping memory;
      memory = get_memory_pointer();
      // Andere bekommen eine anonymisierte Version
      printf("memory: (Nur Feldnamen, keine Daten)\n");
      foreach (string program, mapping data: memory ) {
        if ( mappingp(data) && sizeof(data) ){
          printf(break_string(
                   implode(m_indices(data),";\n"), 78,  
                   sprintf("  %-50s: ",program)),1);
        }
        else
        printf("  %-50s: - leer -\n", program);
      }
    }
  }
  return;
}

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

void ShowData

(

)

---

Variablen-Dokumentation

string* known_programs

Liste mit Programmen, die den Memory nutzen duerfen Die Variable wird entweder im create() oder durch manuellen Aufruf von RereadProgramLists() aus /secure/memory_lib und /secure/memory_nolib befuellt.

MorgenGrauen Mudlib

secure/memory.c -- zum Speichern von Daten ueber die gesamte Mud-Uptime

Memory speichert seine Daten als Pointer in der extra-wizinfo. Andere Programme koennen Ihre Daten im Memory ablegen. Die Daten bleiben dadurch auch ueber ein Update/Reload der Blueprint erhalten.

Die Daten werden auf Klassenebene behandelt. Jeder Clone eines Programms (Blueprint) darf auf die gespeicherten Daten des Programms schreibend und lesend zugreifen. Andere Programme haben keinen Zugriff auf diese Daten.

Nur Objekte in /secure/memory_lib bzw. /secure/memory_nolib eingetragen sind, haben Rechte den Memory zu nutzen.

Die Idee, sensible Daten in der extra_wizinfo abzuspeichern entstammt /secure/memory.c aus der Wunderland Mudlib von Holger

Definiert in Zeile 41 der Datei memory.c.

Wird benutzt von get_caller_hash(), RereadProgramLists() und ShowData().