Hamster-Hilfe (dt.) * Dateistrukturen

Files & Directories: Verzeichnisstruktur

Dateien in "(Hamster-Wurzel)":

Hamster.exe

; Dieses Wahnsinns-Programm

Hamster.hlp

; Die Hilfedatei zu Hamster (engl.).

Hamster.ini

; Einstellungsdatei von Hamster

; Nur manuell änderbare Einträge:

[Setup]

; Unterbindet das Hinzufügen der Headerzeile "X-Posting-Agent" bei neuen Postings / Mails:

news.addxhamster=0

mail.addxhamster=0

; Unterbindet den "Received"-Header (Empfangen-Kopfzeile) von Hamster bei Mails:

mail.addreceived=0

; Wartezeit in Minuten, nach der lokale Server nicht benutzte News- / Mailprogramme abschalten
;(Standarvorgabe: 60):

local.timeout.inactivity=60

; Zeit in Millisekunden, die Hamster abwartet, bevor er eine Verbindung nach Erhalt
; des "Quit"-Befehls schließt (Standarvorgabe: 100 ms):

local.timeout.quitdelay=100

; Zeit in Sekunden, innerhalb der eine Anmeldung am POP3-Server für den Versandprozeß
; von Mails (SMTP-nach-POP3) gültig bleibt (Standarvorgabe 300 Sek.)

local.smtpafterpop3.period=300

; Obergrenze für Zeilenlänge und Textumfang, die an einen der lokalen Server von Hamster gesendet wurden.
; Wird eine der Grenzen überschritten, so wird die Verbindung beendet.
; (Standardvorgabe: 1000 / 2MB, 0 als Wert für das vollständige Ausschalten):
local.limit.linelen.nntp=1000
local.limit.linelen.pop3=1000
local.limit.linelen.smtp=1000
local.limit.textsize.nntp=2097152
local.limit.textsize.pop3=2097152
local.limit.textsize.smtp=2097152

; Zeit in Sekunden, innerhalb der "entfernte" Server antworten sollten, bevor "Server antwortet nicht"
; angenommen wird (Standardvorgabe: 120).

remote.timeout.connect=120

remote.timeout.command=120

; Entfernt die Message-ID aus Mails, die an den lokalen SMTP-Server verschickt werden, falls
; ihr FQDN (Vollständig gültiger Domain-Name) einer aus der (durch Kommata) getrennten Liste ist:

mail.removemids=fqdn1,fqdn2,fqdn3,...

; Bestimmt, wie das Schlüsselwort zur Kodierung der Einträge in der Passwort-Datei ("Password.!!!")
; erstellt wird.

; Wurde der Wert auf "1" gesetzt, wird der Benutzernamen dafür nicht verwendet (z.B. in NT, falls
; Hamster mit verschiedenen; Anmeldekennungen eingesetzt wird).

; Hinweis: Nach Veränderung des Wertes muß Hamster neu gestartet werden und alle Paßwörter
; sind neu zu vergeben!

password.codebase=0

; Falls der Mailversand, egal warum, fehlschlägt, wiederholt Hamster den Vorgang so oft,
; bis eine vorgebene Anzahl erreicht wurde (.max=...).
; Danach wird die nicht beförderte Maildatei entweder in "*.err" umbenannt (.del=0)
; oder gelöscht (.del=1), um weitere Versuche zu verhindern.
sendmail.attempts.max=10
sendmail.attempts.del=0

; Globale Filter für abgerufene Mails basieren auf der Größe der Nachricht
; (aufgezeichnet durch den ersten LIST-Befehl).
; Überschreitet eine Nachricht diesen vorgegebenen Wert, wird sie ignoriert (.ignore),
; gelöscht (.kill) oder eine Info an "admin" gesendet (.notify).
; Ein Wert von 0 (Standard) setzt diese Filter außer Kraft. Er hat Priorität vor den in
; der Datei MailFilt.hst definierten Mailfiltern. mail.filter.mailsize.ignore=0
mail.filter.mailsize.kill=0
mail.filter.mailsize.notify=0

; Anzahl der geladenen Zeilen des Mailtextes beim Abruf der Mailkopfzeilen für die Mailfilter.
; Diese Zeilen sind Teil der Info-Nachricht von ignorierten oder gelöschten Mails.
mail.filter.toplines=20

; Aufbewahrungsdauer in Tagen der Einträge in der Datei MHistory.dat (Standardvorgabe: 14).
purge.mhistory.keepdays=14

; Die Datei "History" ist in viele Dateien aufgeteilt worden; die folgende Einstellung kontrolliert,
; wieviele benutzt werden ("0"=1 Datei, "2"=4 Dateien, ..., "8"=256 Dateien).
; Der Standardeintrag "4" wirkt als Exponent (2^4=16 Dateien), was in den meisten Fällen ausreichend ist.

; Die Zahl der Dateien wird wie folgt geändert (bei Hamsterinstanzen mit weniger als etwa 100.000-200.000
; Artikeln ist das nicht empfehlenswert!):

; 1. Hamster beenden

; 2. Die Einstellungen in "history-chunkbits" sind zu ändern

; 3. Die Dateien "hist*.dat" im Verzeichnis "groups" löschen

; 4. Hamster neu starten, um (das passiert automatisch!) die Datei "History" wiederherzustellen.

history.chunkbits=4

; Definiert den Editor für Skripte. "editor.app" bestimmt das Programm und
; "editor.params" bestimmt die Kommandozeileparameter, wobei "%1" durch
; den Namen der zu bearbeitenden Datei ersetzt wird.
; Standard-Editor ist "Notetab.exe" mit dem Parameter "%1"
editor.app=notepad.exe
editor.params=%1

; Definiert Namen der internen Gruppen von Hamster:

; .default:	für alle Funktionen, falls kein anderer Gruppenname vorhanden ist
; .postok:	Benachrichtigung über erfolgreich ausgelieferte Postings
; .posterrors:	Benachrichtigung über Postings, die nicht abgesetzt wurden
; .statistics:	Tägliche Gruppenstatistik
; .cancelnotify:	Nachricht(en) über Cancel(s) in lokalen Gruppen
; .newgroups:	Info über neu hinzugekommene Newsgroups
; .unknowngroup:	Sammelplatz für Artikel an unbekannte Gruppen

; Standard ist die Speicherung in der Gruppe "internal.misc"
internalgroup.default=internal.misc
internalgroup.postok=
internalgroup.posterrors=
internalgroup.statistics=
internalgroup.cancelnotify=
internalgroup.newgroups=
internalgroup.unknowngroup=

Changes.txt

; Infodatei zu den einzelnen Versionen

Groups.hst

; Liste der (lokal verfügbaren) Hamster-Newsgroups.

Pulls.hst

; Liste der Newsgruppen, die vom Newsserver geladen werden sollen.

Server.hst, SrvPOP3.hst, SrvSMTP.hst

; Liste der NNTP-, POP3- und SMTP-Server.

Password.!!!

; Passwort-Einstellungen.

Accounts.!!!

; Lokale Konten und ihre Einstellungen

IPAccess.hst

; Erlaubt / verweigert Verbindungen aufgrund der Adressen der Nutzer.

Scores.hst

; Scorefile. Wird beim Laden der Postings benutzt.

; (vgl. Killfile-Einstellungen)

MailFilt.hst

; Filter, die beim Abruf von Mails eingesetzt werden.

Ham.exe

; Kommandozeilen-Tool zum Anzeigen und zur Ausgabe von Artikeln.

; (siehe "ham help" für Details)

h*.hsc, demo*.hsc

; (interne) Hamster-Scripts

h*.pl, demo*.pl

; (externe) Perl-Scripts

h*.vbs, demo*.vbs

; (externe) VBScript-Scripts ("Windows Script Host")

Zurück zur Verzeichnis-Struktur

Dateien in "(Hamster-Wurzel)\Server":

allpulls.txt: ; Alte Datei - wird nicht mehr genutzt
alldescs.txt: ; Enthält eine Liste der verfügbaren Newsgroups und ihrer Beschreibung.
Format: Gruppenname TABULATOR Gruppenbeschreibung.

Zurück zur Verzeichnis-Struktur

Dateien in "(Hamster-Wurzel)\Server\(servernames)":

Greeting.txt: ; Einleitende Begrüßungsnachricht der Server.
Groups.txt: ; Gruppenliste dieses Servers.
Help.txt: ; Hilfedatei dieses Servers.
NewGrps.txt: ; Liste der neuen Gruppen dieses Servers (Datei "Groups.txt" wird ebenfalls aktualisiert).
GrpDescs.txt: ; Liste der vom Server geladenen Gruppenbeschreibungen.
Overview.txt: ; Unterstützte Übersichtenfelder (zu Postings) dieses Servers.
Server.ini: ; Serverspezifische Einstellungen.; ; Nur manuell änderbar:; [Setup]; ; Falls "ReadOnly" auf "1" gesetzt ist, wird ein vorhandener Newsserver nicht für das Posten
; von Artikeln verwendet (Standardvorgabe: 0).; ReadOnly=0; ; Im allgemeinen enthält die Zeitangabe "LastGMT" den Zeitpunkt, an dem zuletzt die
; Übersicht über neu hinzugekommene Newsgroups geladen wurden. Um die Update-Information zu
; verhindern, kann der Zeitpunkt auf "NEVER" ("Nie") gesetzt werden.
LastGMT=NEVER; [Newsgroups]; ; Falls "Vierstellige Jahreszahlen" auf "1" gesetzt wurde, wird der Befehl
; NEWGROUPS im Format "YYYYMMDD ..." angefordert (Standard: 0 = 2-stellig).; 4-Digit-Years=0; [Pull]; ; Anzahl der gleichzeitig zu startenden Threads beim Newsabruf (Werte: 0-4, Standard: 2).; ; Hinweis: Die Nutzungsbedingungen einiger Server können eine Beschränkung auf Werte von max. 1, 2
; oder 3 vorschreiben.; ; Der Standardwert "2" dürfte akzeptabel sein; bitte bei Zweifeln den Newsmaster ansprechen, um die Zahl; ; der gleichzeitigen Verbindungen ("Sockets") zu erfragen.; Threads=2
GetMids.txt: ; Liste von Message-IDs, die (noch) von diesem Server zu laden sind (wird für das Nachladen von
; Artikeln aus dem "Killfile-Log" (--> siehe dort) heraus benutzt.; ; Geht einer Message-ID ein "!" voran, wird sie vom Server abgerufen, auch wenn sie bereits
; in der "History-Datei" als bekannt gekennzeichnet ist.

Zurück zur Verzeichnis-Struktur

Dateien in "(Hamster-Wurzel)\Groups":

History.dat - Alte Datei - wird nicht mehr benötigt.: ; Eine Liste von Artikel-Informationen (vorrangig der MD5-Hash (=Index) der Message-ID),
; die zur Wiedererkennung ; bereits geladener Artikel dient und später dem Finden von Artikeln
; anhand der Message-ID.
Hist4??.dat: ; Eine Liste mit Artikelinformationen (in erster Linie ein MD5-Hashwert der Message-ID), die verwendet wird, um bereits geladene Artikel zu identifizieren oder sie später anhand der MID zu finden.
Kills.log: ; Überblicks-Zeile zu Artikeln, die aufgrund von Scorefile-Einträgen nicht geladen wurden.

Zurück zur Verzeichnis-Struktur

Dateien in "(Hamster-Wurzel)\Groups\News.Out":

*.msg: ; Nachrichten, die der News-Client (z.B. Forté Agent, ...) zum lokalen NNTP-server(= Hamster)
; gesandt hat (jeder Artikel in einer eigenen Textdatei). Nach Versand an den Newsserver werden
; sie gelöscht. Wenn entsprechende Einstellungen vorliegen, fügt der Hamster dem Artikel eine
; Message-ID vor dem Absenden hinzu. Dies erfolgt dann - und nur dann - wenn der Artikel keine
; eigene Message-ID besitzt. Hamster selbst wird keine vorhandenen Message-IDs überschreiben.

; BETA-Hinweis:
; Hamster fügt vor dem Posten an einen Newsserver die Zeile "X-Posting-Agent: Hamster Vr. ..."
; in den Kopfbereich ("Header") jedes Artikels ein. (S.o. Hamster.ini - [Setup] *.addxhamster=)

Zurück zur Verzeichnis-Struktur

Dateien in "(Hamster-Wurzel)\Groups\(groupnames)":

data.dat: ; Artikeldaten.
data.idx: ; Index zur Datei "data.dat"
data.ini: ; Gruppenspezifische Informationen und Einstellungen.

Zurück zur Verzeichnis-Struktur

Dateien in "(Hamster-Wurzel)\Mails":

MHistory.dat: Ähnlich der History-Dateien im Verzeichnis \Groups\, wird diese Datei zum Auffinden bereits geladener Mails verwendet.

Zurück zur Verzeichnis-Struktur

Dateien in "(Hamster-Wurzel)\Mails\Mails.Out":

*.msg: ; Mails, die an den lokalen SMTP-Server versendet wurden (jede Mail in einer eigenen Textdatei
; enthaltene "SMTP-envelope"-Zeilen sind durch ein "Ausrufezeichen" ("!") markiert).
; Die Mails werden nach dem erfolgreichen Versand an einen externen SMTP-Server gelöscht.

Zurück zur Verzeichnis-Struktur

Dateien in "(Hamster-Wurzel)\Mails\Admin":

*.msg: ; Mails, die vom externen POP3-Servers geladen wurden (jede Mail in einer eigenen Textdatei).

Zurück zur Verzeichnis-Struktur

Dateien in "(Hamster-Wurzel)\Logs":

0.log, 1.log, 2.log, ...: ; Hamster-Logfiles. Immer, wenn Hamster gestartet wird, werden die Dateinamen
; um "Eins" fortgeschrieben (0.log->1.log, 1.log->2.log, ...).
; "0.log" ist immer das aktuellste Logfile.
MailIn.log: ; Enthält Informationen für jede Mail, die von externen POP3-Servern heruntergeladen wurden.
MailOut.log: ; Enthält Informationen für jede Mail, die an externe SMTP-Server versandt wurden.
RasDial.log: ; Enthält einen Eintrag für jede von Hamster initiierte DFÜ-Wählverbindung.

Zurück zur Verzeichnis-Struktur