System-Dokumentation

Mit der Site Konfiguration sysdoc.conf wird die System-Dokumentation aus dem Ordner /usr/share/doc über den WEB-Server freigegeben. Die Site sysdoc.conf definiert die Directory Resource /usr/share/doc und setzt den Alias /sysdoc auf diese Resource (vergleiche Alias Direktive). Für die Site ist keine Autorisierung zum Zugriff auf Resourcen erforderlich, was über die Direktive Require all granted gesetzt wird. Die Allow, Order und Deny Direktiven werden so gesetzt, dass der Zugriff auf die sysdoc-resource nur aus dem eigenen Subnetzt möglich ist (vergleiche Allow-Direktive). Es werden keine lokalen Options unterstützt, siehe AllowOverride.

<IfModule mod_autoindex.c>

    Alias /sysdoc /usr/share/doc

    <Directory /usr/share/doc>

        Require all granted

        Order deny,allow
        Deny from all
        Allow from fd00::/8 192.168.0.0/16 fe80::/10 127.0.0.0/8 ::1
        AllowOverride None

In dem Kontext der Resource wird noch der Autoindex eingeschaltet, der die Header/Readme Datei aus dem chrome-Ordner verwenden soll (vergleiche Serverside Includes):

        Options +Indexes +FollowSymLinks

        HeaderName /chrome/header.shtml
        ReadmeName /chrome/footer.shtml

    </Directory>

</IfModule>

Die sysdoc-Site sollte nur in einer Entwickler-Umgebung installiert werden. Die sysdoc-Site kann bei Bedarf auch wieder deaktiviert werden:

sudo -H a2dissite sysdoc