Aufbau der Datei 'INFO': Unterschied zwischen den Versionen

Aus
(→‎Erklärung der Schlüsselwörter: Parameter "install_dep_packages" hinzugefügt, Korrekturen bei den Diensten)
(→‎Erklärung der Schlüsselwörter: aktulisierung der Parameterliste)
Zeile 22: Zeile 22:
|package||Paketname, wird für die Erstellung des Verzeichnisses in /var/packages verwendet.||alphanumerisch
|package||Paketname, wird für die Erstellung des Verzeichnisses in /var/packages verwendet.||alphanumerisch
|-
|-
|version||Version des Paketes||alphanumerisch / 1.0
|version||Version des Paketes. Buchstaben sind zwar erlaubt, verhindern aber die Erkennung von Updates (höheren Versionen) durch das Paketzentrum.||alphanumerisch / 1.0-001
|-
|-
|description||ausführliche Beschreibung (default Eintrag für alle Sprachen, falls sprachabhängige Beschreibung nicht verfügbar).||alphanumerisch
|description||ausführliche Beschreibung (default Eintrag für alle Sprachen, falls sprachabhängige Beschreibung nicht verfügbar).||alphanumerisch
Zeile 34: Zeile 34:
|admin_port||Port der externen Administrationsoberfläche||numerisch
|admin_port||Port der externen Administrationsoberfläche||numerisch
|-
|-
|arch||Einschränkung auf eine bestimmte Architektur oder "noarch" (siehe [[Welchen_Prozessortyp_besitzt_mein_System%3F]]).||alphanumerisch / ppc_853x
|admin_protocol||Protokoll für den Aufruf der externen Administrationsoberfläche. ohne Angabe wird http verwendet.||http und/oder https mit Leerzeichen getrennt
|-
|arch||Einschränkung auf eine bestimmte Architektur oder "noarch" (siehe [[Welchen_Prozessortyp_besitzt_mein_System%3F]]).||Architekturen mit Leerzeichen getrennt / 88f6281 88f6282
|-
|-
|reloadui||Neuladen/Aktualisierung des Paket-Zentrums nach der Installation.||yes/no
|reloadui||Neuladen/Aktualisierung des Paket-Zentrums nach der Installation.||yes/no
|-
|-
|firmware||minimale Firmwarewareversion die für die Installation nötig ist.||alphanumerisch, Firmwareversion / 3.0-1593
|firmware||minimale Firmwarewareversion die für die Installation benötigt wird.||numerisch inkl. - und . / 3.0-1593
|-
|-
! colspan="3" |'''*** Neu ab DSM 3.2.1869 beta ***'''
! colspan="3" |'''*** Neu ab DSM 3.2.1869 beta ***'''
|-
|-
|displayname||erweiterter Name für die Anzeige im Paketzentrum. Ist dieser Parameter nicht vorhanden, wird "package" verwendet.||alphanumerisch
|displayname||erweiterter Name für die Anzeige im Paketzentrum. Ist dieser Parameter nicht vorhanden, wird "package" verwendet.||alphanumerisch
|-
|displayname_xxx||erweiterter Name für die Anzeige im Paketzentrum in der jeweiligen Sprache xxx (siehe [[#Sprachkürzeltabelle]]).||alphanumerisch
|-
|checksum||Wenn vorhanden, wird die Checksumme der package.tgz mit dieser verglichen||MD5-String
|-
|checkport||Überprüft, ob ein Konflikt zwischen dem Adminport und einer der vom DSM verwendeten Ports existiert.||yes/no
|-
|-
|helpurl||URL zur Homepage/Forum des Entwicklers für Informationen||URL
|helpurl||URL zur Homepage/Forum des Entwicklers für Informationen||URL
Zeile 48: Zeile 56:
|report_url||URL zur Homepage/Forum des Entwicklers für Pakete im Beta-Stadium, aktiviert automatisch den Text "beta" neben dem Namen im Paket-Zentrum||URL
|report_url||URL zur Homepage/Forum des Entwicklers für Pakete im Beta-Stadium, aktiviert automatisch den Text "beta" neben dem Namen im Paket-Zentrum||URL
|-
|-
|startable||Bestimmt, ob ein Paket gestartet werden darf. Das "start-stop-status"-Script wird bei einem Wert "no" trotzdem benötigt und darf nicht fehlen!||yes/no
|install_reboot||Neustart der DS nach Installation/Aktualisierung eines Paketes. Wenn durch "yes" aktiviert, wird der Parameter "instuninst_restart_services" ignoriert.||yes/no
|-
|instuninst_restart_services||Startet die angegeben Dienste nach einer Installation/Aktualisierung oder Deinstallation eines Paketes neu. Ist ein Dienst nicht aktiviert/gestartet, kann er durch diesen Parameter nicht gestartet werden. Wurde der Parameter "install_reboot" mit "yes" aktiviert, wird dieser Parameter ignoriert.||Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-sys(z.B. Port 5000 oder 5001), apache-web(z.B. Port 80 oder 443), mdns(Multicast DNS Service Discovery), samba, db(MySQL und PostgreSQL), applenetwork(Apple Network), cron, nfs, firewall
|-
|startstop_restart_services||Startet die angegeben Dienste nach dem Ausführen/Stopps eines Paketes neu. Ist ein Dienst nicht aktiviert/gestartet, kann er durch diesen Parameter nicht gestartet werden. Wurde der Parameter "startable" mit "no" deaktiviert, wird dieser Parameter ignoriert.||Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-sys(z.B. Port 5000 oder 5001), apache-web(Port 80 oder 443), mdns(Multicast DNS Service Discovery), samba, db(MySQL und PostgreSQL), applenetwork(Apple Network), cron, nfs, firewall
|-
|dsmappname||Vor einer Aktualisierung/Deinstallation des Paketes wird das Anwendungsfenster geschlossen.||yes/no
|-
|startable||Bestimmt, ob ein Paket gestartet werden darf. Das "start-stop-status"-Script wird bei einem Wert "no" trotzdem benötigt und darf nicht fehlen! Ausführen- und Stopp-Link werden nicht angezeigt.||yes/no
|-
|-
|install_dep_services||abhängige Dienste für die Installation||Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-web(Port 80 oder 443), mysql(MySQL), php_disable_safe_exec_dir (erwartet aktiviertes php_safe_mode_exec_dir)
|install_dep_services||abhängige Dienste für die Installation||Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-web(z.B. Port 80 oder 443), mysql(MySQL), php_disable_safe_exec_dir (erwartet aktiviertes php_safe_mode_exec_dir)
|-
|-
|start_dep_services||abhängige Dienste für den Start||Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-web(Port 80 oder 443), mysql(MySQL), php_disable_safe_exec_dir (erwartet aktiviertes php_safe_mode_exec_dir)
|start_dep_services||abhängige Dienste für den Start||Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-web(z.B. Port 80 oder 443), mysql(MySQL), php_disable_safe_exec_dir (erwartet aktiviertes php_safe_mode_exec_dir)
|-
|-
|install_dep_packages||abhängige Pakete für die Installation. Es ist auch ein Vergleich zu einer bestimmten Version möglich. Hierfür hinter den Paketnamen eines der folgenden Zeichen "< > =" gefolgt von einer Versionsnummer eintragen.||Paketnamen mit Doppelpunkt getrennt, < > = für die Versionsabfrage / Init_3rdparty=1.5:Init_3rdpartyHelp>1.00
|install_dep_packages||abhängige Pakete für die Installation. Es ist auch ein Vergleich zu einer bestimmten Version möglich. Hierfür hinter den Paketnamen eines der folgenden Zeichen "< > =" gefolgt von einer Versionsnummer eintragen.||Paketnamen mit Doppelpunkt getrennt, < > = für die Versionsabfrage / Init_3rdparty=1.5:Init_3rdpartyHelp>1.00
|-
|-
|package_icon||PNG base64-codiert oder als PACKAGE_ICON.PNG im Paket (wird nach der Installation automatisch als base64-codierter Text in INFO geschrieben||base64-codierter Text oder Datei im Format PNG
|package_icon||PNG base64-codiert oder als PACKAGE_ICON.PNG im Paket (wird nach der Installation automatisch als base64-codierter Text in INFO geschrieben. '''Wichtig: Bei Verwendung der Datei "PACKAGE_ICON.PNG" muss nach dem letzten Parameter in INFO unbedingt eine neue Zeile folgen, da sonst der Parameter "package_icon" direkt hinter dem letzten Parameter (in der gleichen Zeile) eingetragen wird.'''||base64-codierter Text oder Datei im Format PNG
|}
|}



Version vom 5. Januar 2012, 17:09 Uhr

Einleitung

Die Datei 'INFO' ist ein wichtiger Bestandteil des Synology Paketes (SPK). Mit dieser Datei legt man den Paketnamen und weitere Einstellungen für das Paket-Zentrum fest.

Aufbau

Im folgenden Beispiel sind die minmal empfohlenen Parameter mit Beispieldaten aufgeführt.

package="Test"
version="1.0"
description="Test App zum Testen"
maintainer="Nobody"
arch="noarch"

Erklärung der Schlüsselwörter

Jede Zeile enthält ein Parameter mit dem entsprechenden Inhalt.

Parameter Beschreibnung Wert/Typ/Beispiel
package Paketname, wird für die Erstellung des Verzeichnisses in /var/packages verwendet. alphanumerisch
version Version des Paketes. Buchstaben sind zwar erlaubt, verhindern aber die Erkennung von Updates (höheren Versionen) durch das Paketzentrum. alphanumerisch / 1.0-001
description ausführliche Beschreibung (default Eintrag für alle Sprachen, falls sprachabhängige Beschreibung nicht verfügbar). alphanumerisch
description_xxx ausführliche Beschreibung in der jeweiligen Sprache xxx (siehe #Sprachkürzeltabelle). alphanumerisch
maintainer Name des Entwicklers alphanumerisch / Nobody
admin_url URL der externen Administrationsoberfläche URL
admin_port Port der externen Administrationsoberfläche numerisch
admin_protocol Protokoll für den Aufruf der externen Administrationsoberfläche. ohne Angabe wird http verwendet. http und/oder https mit Leerzeichen getrennt
arch Einschränkung auf eine bestimmte Architektur oder "noarch" (siehe Welchen_Prozessortyp_besitzt_mein_System?). Architekturen mit Leerzeichen getrennt / 88f6281 88f6282
reloadui Neuladen/Aktualisierung des Paket-Zentrums nach der Installation. yes/no
firmware minimale Firmwarewareversion die für die Installation benötigt wird. numerisch inkl. - und . / 3.0-1593
*** Neu ab DSM 3.2.1869 beta ***
displayname erweiterter Name für die Anzeige im Paketzentrum. Ist dieser Parameter nicht vorhanden, wird "package" verwendet. alphanumerisch
displayname_xxx erweiterter Name für die Anzeige im Paketzentrum in der jeweiligen Sprache xxx (siehe #Sprachkürzeltabelle). alphanumerisch
checksum Wenn vorhanden, wird die Checksumme der package.tgz mit dieser verglichen MD5-String
checkport Überprüft, ob ein Konflikt zwischen dem Adminport und einer der vom DSM verwendeten Ports existiert. yes/no
helpurl URL zur Homepage/Forum des Entwicklers für Informationen URL
report_url URL zur Homepage/Forum des Entwicklers für Pakete im Beta-Stadium, aktiviert automatisch den Text "beta" neben dem Namen im Paket-Zentrum URL
install_reboot Neustart der DS nach Installation/Aktualisierung eines Paketes. Wenn durch "yes" aktiviert, wird der Parameter "instuninst_restart_services" ignoriert. yes/no
instuninst_restart_services Startet die angegeben Dienste nach einer Installation/Aktualisierung oder Deinstallation eines Paketes neu. Ist ein Dienst nicht aktiviert/gestartet, kann er durch diesen Parameter nicht gestartet werden. Wurde der Parameter "install_reboot" mit "yes" aktiviert, wird dieser Parameter ignoriert. Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-sys(z.B. Port 5000 oder 5001), apache-web(z.B. Port 80 oder 443), mdns(Multicast DNS Service Discovery), samba, db(MySQL und PostgreSQL), applenetwork(Apple Network), cron, nfs, firewall
startstop_restart_services Startet die angegeben Dienste nach dem Ausführen/Stopps eines Paketes neu. Ist ein Dienst nicht aktiviert/gestartet, kann er durch diesen Parameter nicht gestartet werden. Wurde der Parameter "startable" mit "no" deaktiviert, wird dieser Parameter ignoriert. Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-sys(z.B. Port 5000 oder 5001), apache-web(Port 80 oder 443), mdns(Multicast DNS Service Discovery), samba, db(MySQL und PostgreSQL), applenetwork(Apple Network), cron, nfs, firewall
dsmappname Vor einer Aktualisierung/Deinstallation des Paketes wird das Anwendungsfenster geschlossen. yes/no
startable Bestimmt, ob ein Paket gestartet werden darf. Das "start-stop-status"-Script wird bei einem Wert "no" trotzdem benötigt und darf nicht fehlen! Ausführen- und Stopp-Link werden nicht angezeigt. yes/no
install_dep_services abhängige Dienste für die Installation Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-web(z.B. Port 80 oder 443), mysql(MySQL), php_disable_safe_exec_dir (erwartet aktiviertes php_safe_mode_exec_dir)
start_dep_services abhängige Dienste für den Start Dienstnamen mit Leerzeichen getrennt / z.Z. mögliche Werte: apache-web(z.B. Port 80 oder 443), mysql(MySQL), php_disable_safe_exec_dir (erwartet aktiviertes php_safe_mode_exec_dir)
install_dep_packages abhängige Pakete für die Installation. Es ist auch ein Vergleich zu einer bestimmten Version möglich. Hierfür hinter den Paketnamen eines der folgenden Zeichen "< > =" gefolgt von einer Versionsnummer eintragen. Paketnamen mit Doppelpunkt getrennt, < > = für die Versionsabfrage / Init_3rdparty=1.5:Init_3rdpartyHelp>1.00
package_icon PNG base64-codiert oder als PACKAGE_ICON.PNG im Paket (wird nach der Installation automatisch als base64-codierter Text in INFO geschrieben. Wichtig: Bei Verwendung der Datei "PACKAGE_ICON.PNG" muss nach dem letzten Parameter in INFO unbedingt eine neue Zeile folgen, da sonst der Parameter "package_icon" direkt hinter dem letzten Parameter (in der gleichen Zeile) eingetragen wird. base64-codierter Text oder Datei im Format PNG

Sprachkürzeltabelle

ger = german
enu = english US
chs = chinese simplified
cht = chinese traditional
csy = czech
jpn = japanese
krn = korean
dan = danish
fre = french
ita = italian
nld = dutch
nor = norwegian
plk = polish
rus = russian
spn = spanish
sve = swedish
hun = hungarian
trk = turkish
ptg = portuguese european
ptb = portuguese brazilian