imported>Y2kbug: /* Verwendung */ RHEL verlinkt

2026-04-06T21:30:17Z

Verwendung: RHEL verlinkt

Neue Seite

Eine '''Initialisierungsdatei''' bzw. kurz '''INI-Datei''', abgeleitet von der meist im [[8.3]]-Schema genutzten [[Dateinamenserweiterung]] <code>.INI</code>, ist eine [[Konfigurationsdatei]] für diverse Software, die die darin gespeicherten Einstellungen für den benutzerdefinierten Start verwendet.<ref>{{Literatur |Autor=Charles Petzold |Titel=PM Functions in Non-PM Programs – As a rule, Presentation Manager functions can be called only from within PM programs. as {{Monospace|INISHOW.EXE}} demonstrates, however, rules can sometimes be broken. |Sammelwerk=[[PC Magazine]] |Band=8 |Nummer=11 |Verlag=[[Ziff Davis]] |Datum=1989-06-13 |Sprache=en |Seiten=343 ff. |Fundstelle=But maybe … |Online={{Google Buch |BuchID=qPzglj0Y0CMC |SeitenID=344}} |Zitat=First, some background. Many applications need to store program initialization or configuration data.}}</ref> Mit der ersten Version von [[Microsoft Windows]], [[Microsoft Windows 1.0|Windows 1.0]],<ref name="expert_guide_to_win98_contents_of_ini_files">{{Literatur |Autor=Mark Minasi, Eric Christiansen, Kristina Shapar |Titel=The Expert Guide to Windows 98 |Verlag=Sybex |Datum=1998 |Sprache=en |Seiten=128 |Fundstelle=Contents of ''.INI'' Files |ISBN=978-0-7821-1974-9 |Online={{Google Buch |BuchID=yTPz-6j0nnoC |Seite=128}} |Zitat=It's hard to draw a clear and distinct line between what {{Monospace|SYSTEM.INI}} and {{Monospace|WIN.INI}} do, as {{Monospace|WIN.INI}} has existed since the Windows 1.0 days and {{Monospace|SYSTEM.INI}} has only been around since version 3.0. Although it's tempting to say that {{Monospace|SYSTEM.INI}} controls the hardware configuration of Windows, and {{Monospace|WIN.INI}} contains user preferences and software configuration, that's not 100 percent accurate.}}</ref> wurde die Initialisierungsdatei <code>WIN.INI</code> dafür verwendet, die in der Systemsteuerung angepassten Benutzereinstellungen für den nächsten Windows-Start zu speichern.<ref>{{Literatur |Autor=Paul W. Ross |Titel=The Handbook of Software for Engineers and Scientists |Verlag=CRC Press |Datum=1996 |Sprache=en |Kapitel=2.7 Customizing the Windows Environment |Seiten=28 ff. |Fundstelle=Modifying the Initialization Files |ISBN=0-8493-2530-7 |Online={{Google Buch |BuchID=LTi_DN_LCSIC |Seite=28}} |Zitat=Each time you start Windows, a set of files is read informing Windows of how to set various configuration options.}}</ref> Dieses Windows-'''INI-Format''' oder ein daran angelehntes Textformat wurde später nicht nur von Windows-[[Anwendungsprogramm|Anwendungen]] übernommen, es wird auch von diversen Programmen [[betriebssystemübergreifend]] genutzt, u. a. um Einstellungen [[Persistenz (Informatik)|dauerhaft zu speichern]].

Dem Windows-Standard folgend sind INI-Dateien meist einfache [[Textdatei]]en, zunächst im [[American Standard Code for Information Interchange|ASCII]]-[[Zeichensatz]], die Schlüssel-Wert-Paare enthalten, die ggf. durch Sektionen gegliedert werden.<ref name="Handbook_of_Software_for_Engineers_and_Scientists-modifying_the_initialization_files" /> Da jedes Programm eigene INI-Dateien definieren kann, entspricht das genaue Format jedoch möglicherweise nicht dem von Microsoft vorgegebenen Standard. Beispielsweise nutzt [[OS/2]] [[Binärdatei|binäre]] INI-Dateien.<ref>{{Literatur |Autor=Charles Petzold |Titel=PM Functions in Non-PM Programs – As a rule, Presentation Manager functions can be called only from within PM programs. as {{Monospace|INISHOW.EXE}} demonstrates, however, rules can sometimes be broken. |Sammelwerk=[[PC Magazine]] |Band=8 |Nummer=11 |Verlag=[[Ziff Davis]] |Datum=1989-06-13 |Sprache=en |Seiten=343 ff. |Fundstelle=WIN.INI and OS2.INI |Online={{Google Buch |BuchID=qPzglj0Y0CMC |SeitenID=344}} |Zitat=The WIN.INI file created by ''Microsoft Windows'' in the \WINDOWS directory is in many ways similar to OS2.INI, and the functions that ''Windows'' provides applications to use WIN.INI are similar to the Presentation Manager functions. The most significant difference is that WIN.INI is an editable ASCII file, while OS2.INI is a binary file. … directly editing the OS2.INI file is not possible, though much of the system information in OS2.INI can be changed by using the Presentation Manager Control Panel program. … Programs can store information in OS2.INI only through PM functions, such as WinWriteProfileData.}}</ref>

Bis zur Einführung der [[Registrierungsdatenbank]] mit [[Microsoft Windows NT 3.1|Windows NT 3.1]] war die {{Monospace|WIN.INI}} die einzige Initialisierungsdatei zur Speicherung von Programm-Konfigurationen, was durch die [[WinAPI]] unterstützt wurde. In späteren Windows-NT-Versionen ist der API-Zugriff zwar noch vorhanden, wird aber als veraltet angesehen.<ref>{{Internetquelle |autor=Gerhard Stephan |url=http://jachman.wordpress.com/2006/09/11/how-to-access-ini-files-in-c-net/ |titel=How to access INI Files in C# .NET |titelerg= |werk=All about nothing – .NET C#, Oracle, SQL Server and all other stuff that gives live a sense. |datum=2006-09-11 |format=[[Blog]] |sprache=en |offline=1 |archiv-url=https://web.archive.org/web/20061120014725/jachman.wordpress.com/2006/09/11/how-to-access-ini-files-in-c-net/ |archiv-datum=2006-11-20 |abruf=2024-07-01 |abruf-verborgen=1 |zitat=Sometimes you’ll find your self in a situation where you need to use outdated techniques in order to support outdated applications … That time you’ll recognize that .NET does not support INI Files anymore.}}</ref>

Das INI-Format von Windows gilt als einfach aufgebautes und zugleich [[Menschenlesbarkeit|von Menschen leicht lesbares]] [[Dateiformat]], das grundsätzlich mit jedem [[Texteditor]] bearbeitet werden kann. Allerdings sind die Bezeichnungen der Einstellungen damit keineswegs auch selbsterklärend und aussagekräftig.<ref name="PC_Magazin-getting_more_out_of_windows-winini-comments">{{Literatur |Autor=William S. Hall |Titel=Getting More Out of Windows |Sammelwerk=[[PC Magazine]] |Band=8 |Nummer=11 |Verlag=[[Ziff Davis]] |Datum=1989-06-13 |Sprache=en |Seiten=385 ff. |Fundstelle=WIN.INI |Online={{Google Buch |BuchID=ofXGcGVTvoEC |SeitenID=390}} |Zitat=As you can see, a WIN.INI entry is fairly readable. That doesn't necessarily mean it makes a lot of sense—it's always wise to look at the relevant documentation if the meaning of a particular field isn't clear. Comments can be placed in WIN.INI by using a semicolon. … In some older versions of ''Windows''m placing an = or bracketed text in a commented line could cause problems. Despite the semicolon, the line was often interpreted as a section name or as keyname=value. It's probably a good idea to avoid the use of =, [, or ] in a comment.}}</ref>

== Aufbau ==
Die Initialisierungsdaten werden zeilenweise abgelegt: ein Gleichheitszeichen trennt den Schlüssel von seinem Wert.<ref name="Handbook_of_Software_for_Engineers_and_Scientists-modifying_the_initialization_files">{{Literatur |Autor=Paul W. Ross |Titel=The Handbook of Software for Engineers and Scientists |Verlag=CRC Press |Datum=1996 |Sprache=en |Kapitel=2.7 Customizing the Windows Environment |Seiten=28 ff. |Fundstelle=Modifying the Initialization Files |ISBN=0-8493-2530-7 |Online={{Google Buch |BuchID=LTi_DN_LCSIC |Seite=28}} |Zitat=Windows initialization files are ASCII text files, and have the following format:<code> [section name] keyname=value</code>}}</ref>
<syntaxhighlight lang="ini">
Schlüssel=Wert
</syntaxhighlight>

Um Schlüssel in sog. Sektionen zu gruppieren, ist eine (pro Datei eindeutige) Bezeichnung in eckigen [[Klammer (Zeichen)|Klammern]] über der jeweiligen Sektion anzugeben. Benannte Sektionen sind nicht verpflichtend, je Sektion müssen die Schlüssel eindeutig sein.

<syntaxhighlight lang="ini">
[Sektion1]
Schlüssel=Wert
[Sektion2]
Schlüssel=Wert
Schlüssel2=Wert
</syntaxhighlight>

Außerdem erlaubt das Dateiformat [[Kommentar (Programmierung)|Kommentarzeilen]], diese beginnen mit einem [[Semikolon]].<ref name="PC_Magazin-getting_more_out_of_windows-winini-comments" />

<syntaxhighlight lang="ini">
; Kommentar
</syntaxhighlight>

== Verwendung ==
Die Verwendung von Daten und Dateien, die an Anlehnung an das von Microsoft kreierte INI-Format gehalten sind, ist mannigfaltig.

Einige Beispiele:
* Die Konfigurationsdateien für [[Apache Subversion|Subversion]]-Repositories nutzen das INI-Format.<ref>{{Internetquelle |url=https://www.visualsvn.com/support/svnbook/advanced/confarea/ |titel=Chapter 7. Customizing Your Subversion Experience |werk=VisualSVN |hrsg=VisualSVN Software Ltd. |sprache=en |abruf=2026-04-06 |zitat=The Subversion runtime configuration area is a two-tiered hierarchy of option names and their values. Usually, this boils down to a special directory that contains configuration files (the first tier), which are just text files in standard INI format where “sections” provide the second tier. You can easily edit these files using your favorite text editor (such as Emacs or vi), and they contain directives read by the client to determine which of several optional behaviors the user prefers.}}</ref>
* Der [[Network Manager]] unter Linux speichert die Profile im INI-Format unter <code>[[Filesystem Hierarchy Standard#/etc|/etc]]/NetworkManager/system-connections/<Verbindungs-Bezeichnung>.nmconnection</code><ref>{{Internetquelle |url=https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/8/html/configuring_and_managing_networking/assembly_networkmanager-connection-profiles-in-keyfile-format_configuring-and-managing-networking |titel=Chapter 38. NetworkManager connection profiles in keyfile format |werk=Red Hat Documentation – [[Red Hat Enterprise Linux]] |hrsg=[[Red Hat]] |sprache=en |abruf=2026-04-06 |zitat=The keyfile format is an INI-like configuration for network connections.}}</ref>
* Die für [[Unixoides System|Unix-artige Systeme]] von [[freedesktop.org]] standardisierten XDG-Desktop-Programmverknüpfungen mit der Dateiendung <code>.desktop</code> sind im INI-Format.<ref>{{Internetquelle |url=https://wiki.archlinux.org/title/Desktop_entries |titel=Desktop entries |werk=Arch Wiki |hrsg=[[Arch Linux]] |format=[[Wiki]] |sprache=en |abruf=2026-04-06 |zitat=The format of desktop entries is similar to INI files.}}</ref>
* Die Daten von [[WireGuard]] zum Einrichten einer VPN-Verbindung verwenden das INI-Format. Die Daten können zwar auch manuell eingegeben werden, meist bieten WireGuard-Clients jedoch das direkte Laden der Daten aus einer INI-Datei, die Übertragung per [[Kopieren und Einfügen]] oder das Einlesen per [[QR-Code]].<ref>{{Internetquelle |autor= |url=https://www.man7.org/linux/man-pages/man8/wg.8.html |titel={{Monospace|wg(8)}} |werk=Linux manual page |hrsg=man7.org |datum=2015-08-15 |format=[[Manpage]] |sprache=en |abruf=2026-04-06 |zitat=The configuration file format is based on INI.}}</ref><ref>{{Heise online |ID=10269892 |Titel=Gleichzeitige WireGuard-Verbindungen |Autor=Andrijan Möcker |Datum=2025-02-14 |Abruf=2026-04-06 |Zitat=Das Open-Source-Projekt kommt als Docker-Container und bietet eine Weboberfläche, über die Sie komfortabel Peer-Profile erstellen und herunterladen oder als QR-Code weitergeben können.}}</ref>

== Regeln ==
{{Belege fehlen|1=Die Behauptungen zu den Regeln und zum Aufbau von Windows-INI-Dateien sind vollkommen unbelegt und u.U. auch falsch. ‣[[Benutzer:Y2kbug|Andreas]]•[[Benutzer_Diskussion:Y2kbug|⚖]] 14:10, 1. Jul. 2024 (CEST)|2=Die nachfolgenden Absätze dieses Abschnitts|Plural=1}}
Beim Erstellen einer INI-Datei sind folgende Regeln zu beachten:
* Jede Sektion darf nur einmal vorkommen.
* Jeder Schlüssel darf nur einmal je Sektion vorkommen.
* Auf Werte wird mittels Sektion und Schlüssel zugegriffen.
* Kommentare werden mit einem „;“ eingeleitet.
* Kommentare dürfen nur auf separaten Zeilen (nicht hinter Sektionsüberschriften oder Schlüsseln) stehen.
* Leerzeichen und Anführungszeichen werden von verschiedenen Programmen teilweise unterschiedlich behandelt.
* [[Groß- und Kleinschreibung]] wird nicht unterschieden
* [[Aussagenlogik]]: False und No werden als 0, True und Yes als 1 interpretiert.

Es gibt Dateien mit nahezu demselben Aufbau, die sich lediglich durch folgende Merkmale unterscheiden:
* Fehlende oder andere Dateiendung (z. B. .conf und .cfg)
* Einleitung von Kommentaren mit einem anderen Zeichen (z. B. „#“).

== Alternative Formate ==
{{Hauptartikel|Konfigurationsdatei}}

== Speicherort ==
{{Belege fehlen|1=Die Angaben zu Windows sind komplett unbelegt und zudem unvollständig bzw. veraltet (nur Windows XP/Vista, aber keine früheren/späteren Versionen von Windows). ‣[[Benutzer:Y2kbug|Andreas]]•[[Benutzer_Diskussion:Y2kbug|⚖]] 14:13, 1. Jul. 2024 (CEST)|2=Dieser Abschnitt}}
[[Datei:Bid-O-Matic path.png|mini|Beispiel einer benutzerfreundlichen Auswahlmöglichkeit zur Festlegung des Speicherortes]]

In früheren [[Microsoft Windows|Windows]]-Ausgaben (mit der Einführung von [[NTFS]]) existierten zwei alternative/konkurrierende Philosophien für den Standard-[[Dateipfad]] zur INI-Ablage, wobei auf der einen Seite die [[Benutzerfreundlichkeit]] und auf der anderen Seite die [[Sicherheit]] im Vordergrund stand.

Im Folgenden am Beispiel von [[Microsoft Windows XP|Windows XP]]:

* <code>\Dokumente und Einstellungen\''<Benutzername>''\Anwendungsdaten\''<Programmname>''\</code> (allgemein, über eine sogenannte [[Umgebungsvariable]]: <code>%APPDATA%\<Programmname></code>; englisch: <code>\Documents and Settings\''<Benutzername>''\Application Data\''<Programmname>''\</code>)
* <code>\Programme\''<Programmname>''\</code> (allgemein: <code>%PROGRAMFILES%\<Programmname></code>; englisch: <code>\Program Files\''<Programmname>''\</code>)

Ab [[Microsoft Windows Vista|Windows Vista]] wird die Veränderung des Programme-Ordners durch Benutzer mit eingeschränkten [[Zugriffsrecht|Rechten]] (oder ''Nicht-[[Administrator (Rolle)|Administratoren]]'') standardmäßig von der [[Benutzerkontensteuerung]] blockiert, wovon auch dort gespeicherte INI-Dateien betroffen sind. Manche Programme vergeben daher bei der [[Installation (Computer)|Installation]] sämtliche Rechte für die installierten Dateien an den Benutzer „Jeder“. In diesen Windows-Versionen existieren ggf. zudem automatisch erzeugte Kopien der INI-Dateien im [[Roaming (Ordnerüberblendung)|Schattenverzeichnis]] <code>$USERDIR$\AppData\Local\VirtualStore\Windows\</code>.

Anwendungen, die ihre Einstellungen in ihrem eigenen Programmordner ablegen (beispielsweise <code>%PROGRAMFILES%\<Programmname>\</code> oder <code>%UserProfile%\Desktop\<Programmname>\</code>), bieten den Vorteil, dass sie leichter auf einen anderen Rechner übertragbar sind, haben aber den Nachteil, dass sich alle Benutzer der Anwendung auf einem Rechner diese Einstellungen teilen. Solche Anwendungen werden auch als ''[[Portable Software|portabel]]'' bezeichnet. Voraussetzung zum Ändern dieser Einstellungen ist, dass der Benutzer Schreibrechte auf die INI-Datei (und den Programmordner) besitzt.

== Weblinks ==
* [http://msdn.microsoft.com/de-de/library/ms724353.aspx GetPrivateProfileString]: Microsoft Windows API-Funktion zum Auslesen von Werten aus einer INI-Datei.
* [http://msdn.microsoft.com/de-de/library/ms724348(VS.85).aspx GetPrivateProfileSection]: Microsoft Windows API-Funktion zum Auslesen von allen Schlüsseln und Werten aus einer Sektion der INI-Datei.
* [http://msdn.microsoft.com/de-de/library/ms724352(VS.85).aspx GetPrivateProfileSectionNames]: Microsoft Windows API-Funktion zum Auslesen von Sektionen aus einer INI-Datei.
* [https://github.com/brofield/simpleini simpleini] – eine plattformübergreifende C++-Bibliothek, die ein einfaches API zum Lesen und Schreiben von Konfigurationsdateien im INI-Format bietet
* [https://github.com/MidnightCommander/mc/blob/master/misc/mc.ext.ini.in mc.ext.ini] – Beispiel für eine moderne INI-Datei im Windows-INI-Format: die „[[Dateinamenserweiterung|Extension]]“-Datei des [[Midnight Commander]]

== Einzelnachweise ==
<references />

[[Kategorie:Datenserialisierungformat]]
[[Kategorie:Konfiguration (Computer)]]
[[Kategorie:Microsoft Windows]]
[[Kategorie:Beschreibungssprache]]

Initialisierungsdatei - Versionsgeschichte

imported>Y2kbug: /* Verwendung */ RHEL verlinkt