elf_hash(3E) elf_hash(3E)
NAME
elfhash - Hash-Wert berechnen
SYNTAX
cc [option ...] datei ... -lelf [bibliothek ...]
#include <libelf.h>
unsigned long elfhash(const char *name);
BESCHREIBUNG
elfhash() berechnet einen Hash-Wert zu der nullzeichen-terminierten
Zeichenkette name. Der zurückgelieferte Hash-Wert h kann als Bucket-
Index verwendet werden, meist nach der Berechnung von h mod x, um die
Einhaltung der entsprechenden Grenzen sicherzustellen.
Hash-Tabellen können auf einer Maschine erzeugt und auf einer anderen
verwendet werden, da elfhash() vorzeichenlose Arithmetikoperationen
benutzt, um mögliche Unterschiede in der vorzeichenbehafteten Arithme-
tik zwischen unterschiedlichen Maschinen zu umgehen. Obwohl name oben
als char* angegeben ist, behandelt elfhash() diesen Wert als unsigned
char*, um Unterschiede bei der Behandlung des Vorzeichens zu vermei-
den. Die Benutzung von char* vermeidet Typkonflikte bei Ausdrücken wie
elfhash("name").
Die Hash-Tabellen von ELF-Dateien werden mit dieser Funktion berechnet
[siehe elfgetdata(3E) und elfxlate(3E)]. Es ist sichergestellt, daß
der zurückgegebene Hash- Wert nicht dem Bitmuster mit nur gesetzten
Bits (~0UL) entspricht.
SIEHE AUCH
elf(3E), elfgetdata(3E), elfxlate(3E).
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98