Unter Subdomains verstehen wir hier Domains auf dritter Ebene. Bei einer Domain wie www.example.com wäre www auf dritter Ebene, damit eine Subdomain von example.com. Entgegen vielen anderen Providern hat die Subdomain "www" bei Hostsharing keinerlei Sonderbedeutung, außer dass sie initial angelegt ist.

Subdomain anlegen

Eine Subdomain wird angelegt, indem man einfach ein neues Verzeichnis unterhalb des Verzeichnisses subs im jeweiligen Domain-Verzeichnis erzeugt. Dort ist bereits das Verzeichnis www angelegt, dies passiert beim Anlegen einer neuen Domain immer automatisch.

Nur der Domain-Admin ist zum Anlegen eines neuen Verzeichnisses berechtigt; will es der Paket-Admin machen (falls nicht identisch mit dem Domain-Admin), dann muss dieser zuvor mit sudo -p xyz00-doms die Idendität des Domain-Admins annehmen.

Per FTP geht es natürlich auch.

Beispiel:

Die Subdomain bilder.example.com soll in Zukunft von xyz00-otto administriert werden. Zunächst muss natürlich der User xyz00-otto angelegt werden: Anleitung zum Anlegen eines neuen Users.
Dann als Paketadmin die Subdomain an den User xyz00-otto delegieren:

xyz00@hopi:~$ ln-sub -a otto bilder.example.com

Außerdem muss eine leere Datei ln-sub.upd im Sub-Verzeichnis des Subdomain-Users angelegt werden:

xyz00@hopi:~$ sudo -u xyz00-otto bash --login
xyz00-otto@hopi:~$touch users/otto/subs/ln-sub.upd

xyz00-otto@hopi:~$exit

Den Rest erledigt der Robot automatisch. Er läuft zur Zeit alle 5 Minuten. Falls inkonsistente Zustände entdeckt werden, schreibt er eine entsprechende Fehlermeldung in die Datei ~/var/conf.err des Paketes.

Da CGI-Skripte in den administrativen Teil fallen, bleiben diese bei einer solchen Delegation beim Domain-Admin. Der Subdomain-Inhaber kann lediglich Inhalte (aber auch PHP-Skripte) hochladen.

Es können in den so delegierten Subdomains CGI-Skripte aus dem CGI-Verzeichnis der Domain ausgeführt werden, nicht aber der php-wrapper um zum Beispiel PHP5 zu verwenden. Der Grund liegt in der Art der Umleitung. Eine per ln-sub delegierte Subdomain wird nicht durch einen eigenen Virtual-Host in der zentralen Konfiguration behandelt, so dass der Wrapper entweder unter der UserID des Besitzers der Hauptdomain oder dem Webserver laufen würde. Beide Fälle werden aus Sicherheitsgründen verhindert.

Sollten bereits Daten unter der Subdomain liegen, wird es komplizierter, da der erste User keinen Zugriff auf die Verzeichnisse des zweiten hat, und der zweite User nicht auf die Verzeichnisse des ersten. In diesem Fall müssten die Daten zwischen den beiden Schritten umkopiert werden.