Net-Base Magasin

03.11.2026

Delphi: INI/Config atomisk opdatering – Write-through med temp-fil, Flush og crash-sikkerhed

Når INI-filer bliver korrupte efter et crash eller kill, hjælper et robust Replace-Pattern: midlertidig fil i målmappen, Flush/Write-through og atomar udskiftning via ReplaceFile. Med beslutningssti, faldgruber og debugging.

03.11.2026

Fra magasinets tema til projektpraksis

Passende service- og tekniske sider til artiklen

Øjeblikket er uanseligt: en tjeneste lukker ned, en autoupdater udskifter filer, Joblisten får et klik for meget – og netop imens gemmes en INI. Ved næste opstart kommer der så ikke en „Konfiguration mangler“-dialog, men et reelt driftsproblem: tjenesten starter ikke, grænsefladen forbliver nede, ticketen ender hos det forkerte team, og til sidst finder nogen en 0-Byte-INI i programmappen.

Hvis du står over for beslutningen om at implementere Delphi: Atomisk opdatering af INI/Config, handler det sjældent om „Clean Code“. Det er en målkonflikt: så lidt I/O- og fejlsøgningslogik som muligt versus pålidelig adfærd ved crash, kill eller strømafbrydelse. Den, der skriver konfiguration i produktionsnære miljøer (Windows- og Linux-Services, terminalservere, kiosk, planlagte jobs), har ofte ikke råd til den naive variant.

Dette indlæg følger en beslutningssti: hvilke muligheder der findes, hvad de reelt gør i fejltilfælde, hvilke Windows-mekanismer der ligger bag (Write-through, Flush, atomarer Replace) og hvilket første skridt der straks øger driftssikkerheden – uden at gøre en INI til et stort projekt.

Delphi: Atomisk opdatering af INI/Config i praksis

Testaufbau mit Rechnern und Netzschalter zur Simulation harter Abbrüche beim Speichern von Konfigdateien
Reproducerbare crash-tests: gentagen gemning og tvungen afslutning under kontrollerede forhold.
Arbeitsplatzszene mit Datenträger und unscharfem Diagnosefenster als Hinweis auf Handle- und Lock-Debugging
Når Replace sporadisk fejler, er åbne handles og scannere ofte årsagen – fejlkoderne afgør.
Abstrakte Grafik eines Dateischreibpfads mit Temp-Datei, Flush-Schritt und atomarem Ersetzen der Zieldatei
Den robuste forløb som systemkæde: skrive, flush, atomisk erstatte – uden UI-detaljer.

Før I sammenligner API’er, klarlæg risikoklassen. Det er ikke en akademisk øvelse, men afgør, hvor meget nedbrudssikkerhed I reelt skal købe.

  • Ikke-kritisk: Vinduespositioner, sidst åbnede lister, UI-layout. Reset er acceptabelt.
  • Relevant: Endepunkter, stier, feature-toggles, mandant-/licensparametre. Fejl medfører supportarbejde og tids tab.
  • Kritisk: Service-startparametre, job-styring, sikkerhedsrelevante afbrydere. Fejl kan forårsage nedetid eller svække beskyttelsesforanstaltninger.

Fra „relevant“ er en atomisk erstatning som regel en velanbragt indsats. Fra „kritisk“ bør I snarere forvente, at et robust lagringsmønster er obligatorisk – plus tests, der virkelig rammer det tidspunkt, hvor processen bliver dræbt.

Muligheder i sammenligning: Hvad sker der virkelig ved et nedbrud?

Den typiske fælde: Man vurderer muligheder efter „hvor tit virker det“, ikke efter „hvor ødelagt bliver det, hvis det går galt“. Følgende matrix er derfor bevidst formuleret ud fra driftssynspunkt.

Option Implementeringsindsats Adfærd ved nedbrud/Kill Almindelige faldgruber Passer, når …
Skrive direkte i målfilen lav Risiko: delvist indhold, 0 byte, ugyldigt format Afbrud midt i skriv; konkurrerende scannere/indexere Konfiguration kan kasseres og er ikke startkritisk
Skriv temp-fil, derefter Rename/Move middel Ofte konsistent, men ikke nødvendigvis „durable“ uden flush Temp på andet volume; Copy+Delete i stedet for Rename; metadata i cache I ønsker atomaritet, men ingen maksimal persistensgaranti
Temp + Flush + ReplaceFile (atomisk erstatning) mittel Meget robust: enten gammel eller ny fil, sjældent „imellem“ Sharing-violations, rettigheder/ACL’er, volume-regel, backup-sti Konfiguration er relevant/kritisk eller I driver services/kiosk
Journal-/transaktionsformat (Append + Commit) høj Maksimal kontrol (replay/rollback muligt) Flere tests, migration, tooling, log-rotation Mange writes, flere writere eller behov for auditerbare ændringer

Kernekonflikten: Atomaritet er ikke det samme som persistens

Mange teams stopper ved „Temp-Datei + Rename“ – forståeligt, da det forhindrer direkte overskrivning. Men nedbrudssikkerhed har to niveauer:

  • Atomaritet: Læsere skal enten se den gamle eller den nye version, ikke en mellemliggende tilstand.
  • Persistenz („durable write“): Efter strømsvigt skal den nye version virkelig ligge på lagringsmediet – ikke kun i cachen.

Windows buffrer skriveoperationer typisk i systemcachen. Uden eksplicit Flush bestemmer cache-algoritmen, hvornår data skrives til lagringsmediet.[Quelle] Praktisk konsekvens: Et mønster kan se „logisk rent“ ud og alligevel gå galt ved strømtab, hvis du hverken bruger Write-through eller udfører et flush.

I mange virksomhedsapplikationer er atomaritet det større løft (ingen ødelagt INI). Persistens bliver kritisk dér, hvor enheder slukkes hårdt, i embedded/industrielle miljøer eller hvor konfigurationsændringer er sjældne, men ved fejl gør maksimal skade.

Den robuste vej: Temp-fil, Write-through/Flush, derefter atomar udskiftning

Hvis du vælger „robust“, bør dit lagringsmønster være klart og kontrollerbart. Ikke som et magisk utility, men som en følge af verificerbare trin:

  1. Opret en temp-fil i målmappen (eller i det mindste garanteret på samme volumen). Det er en forudsætning for, at et Replace virkelig er et Replace – og ikke en Copy+Delete.
  2. Skriv fuldstændigt til temp-filen (inkl. valg af encoding; luk filen, så buffere når I/O-stakken).
  3. Start persistensen: Åbn filhåndtaget med FILE_FLAG_WRITE_THROUGH og/eller kald FlushFileBuffers. Microsoft beskriver Write-through som skrivning „uden forsinkelse“ fra cachen; for metadata- og end-to-end-durability henviser CreateFile-dokumentationen fortsat til FlushFileBuffers.[Quelle]
  4. Udfør atomar udskiftning: Brug ReplaceFileW (valgfrit med backup). Det kapsler udskiftningen som én operation og er designet til dette formål.
  5. Gør fejlsituationer synlige: Hvad sker der ved Sharing-Violation, manglende rettigheder eller manglende måldatei? Log trin og fejlkode.

Et detail er ikke til forhandling: ReplaceFileW kræver, at den udskiftede fil og erstatningsfilen ligger på samme volumen.[Quelle] Netop derfor er „Temp in %TEMP%“ en farlig standard: I Roaming-/VDI-scenarier eller ved omdirigerede profiler kan volumen variere, og dit „atomare“ trin er pludselig ikke længere atomart.

Delphi-INI-klasser — korrekt placering: UpdateFile er ikke jeres crash-sikkerhedsanker

TIniFile og TMemIniFile er bekvemme og i mange projekter fuldt tilstrækkelige. Forskellen er groft sagt: TMemIniFile samler ændringer i hukommelsen og skriver bundtet; TIniFile arbejder tættere på filen (afhængigt af implementering/version). For crash-sikkerhed er det dog afgørende, hvad „Update“ i sidste ende reelt betyder.

RAD Studio-dokumentationen for System.IniFiles.TIniFile.UpdateFile beskriver skrivning af buffrede data, men nuancerer effekten historisk (under NT kunne det „have ingen effekt“).[Kilde] Praktisk konsekvens: UpdateFile er nyttigt til problemet med at komme ”ud af Delphi-buffringen“, men det er ikke det sidste skridt for crash- eller power-loss-scenarier.

Hvis jeres konfiguration er driftkritisk, behandl INI-skrivelser som enhver anden persistente ændring: I har brug for et mønster, der er korrekt på file-handle- og filsystemniveau.

ReplaceFileW eller MoveFileEx? Beslut ud fra semantik

Begge veje kan „erstatte“, men semantikken er ikke identisk. Netop disse nuancer afgør, om jeres support senere ser „sporadisk ødelagt“ eller „klar fejlkode“.

ReplaceFileW: erstatning med valgfri backup

ReplaceFileW er designet til use-casen „erstat målfiler med en erstatningsfil“. I kan valgfrithave en backup-fil oprettet, og i mange tilfælde bevares attributter for målobjektet. Til konfiguration er det ofte passende, fordi en backup ved fejl giver den hurtigste rollback — også uden debugger.

MoveFileEx: generel rename/move, med flags

MoveFileEx med MOVEFILE_REPLACE_EXISTING kan også erstatte. I de gængse headers findes også MOVEFILE_WRITE_THROUGH for at håndtere move/replace som write-through. Udfordringen er ikke så meget „kan ikke“, men „I skal selv sammensætte den semantik, I ønsker“ (backup, attributter, fejlhåndtering, tests).

For en INI, der påvirker tjenestestart, er ReplaceFileW ofte det klarere valg. Til meget simple tilfælde kan MoveFileEx være tilstrækkeligt — men så bør I bevidst acceptere og teste konsekvenserne (ingen backup, forskellig semantik).

Faldgruber, som i praksis reelt giver tickets

Temp-fil i forkert mappe (og pludselig er det Copy+Delete)

Hvis temp-filen og målet ikke ligger på samme volumen, kan udskiftningen ikke være atomar. Det er særligt snedigt, fordi det på udviklermaskiner „altid virkede“ og først fejler i kundemiljøer (omdirigerede profiler, anden drevkortlægning, App-V/VDI).

AV/Indexer/Backup-Agent holder målet kort åbent

Konfigurationsfiler scannes eller indekseres ofte. Så fejler Replace sporadisk med Sharing-Violation. Det er ingen grund til at forkaste mønsteret – men en grund til at logge fejlkoder og implementere et kort, afgrænset retry med backoff (f.eks. få forsøg inden for nogle hundrede millisekunder). Vigtigt: Retries må ikke blokere Shutdown/Service-Stop.

ACLs und Ownership: Nach dem Replace stimmen die Rechte nicht mehr

Hvis den oprindelige fil blev oprettet af installeren med bestemte ACL’er, kan en nyoprettet fil få andre tilladelser. ReplaceFile kan bevare attributter, men det er ingen undskyldning for ikke at kontrollere. For driften tæller i sidste ende kun: Kan Service-Identity efter opdatering læse og skrive? Planlæg denne testcase, især ved Programfiler vs. Programdata.

Mehrere Writer: Atomar ersetzt, aber logisch verloren

Atomar Replace forhindrer „halvskrevet“, ikke „overskrevet“. Hvis to processer gør „læse → ændre → skrive“, vinder den sidste. Hvis I virkelig har to writere (Service + Admin-Tool), har I brug for koordination: mutex, lock-fil eller et centralt ledd, der serialiserer skriverier. Ellers løser I kun ét problem og skaber et nyt.

Debugging-Ansatz: So machen Sie den Crash-Randfall reproduzierbar

Crash-sikkerhed kan man ikke „tro“ på; man må provokere den. En brugbar test er ikke elegant, men entydig.

  1. Stress-Schreiben: Gem i tæt rækkefølge og varier længde/indhold, så forskellige skrivemønstre opstår.
  2. Hard Kill: Afslut processen hårdt under gemningen (f.eks. taskkill /F). Ikke „Close“, ikke „Exit“.
  3. Nach jedem Neustart validieren: Filen må ikke være 0 byte, skal kunne parses, obligatoriske nøgler skal eksistere.
  4. Schrittweises Logging: Log ikke „Save OK“, men: Temp oprettet, Temp skrevet, Flush OK/fejlkode, Replace OK/fejlkode, Backup ja/nej.
  5. Umgebung variieren: SSD/HDD, VM med hårdt poweroff, terminalserver-profil, netværksshare (hvis relevant).

Hvis du i logs senere kun ser „Settings saved“, hjælper det ingen. Hvis du derimod ser „Replace fehlgeschlagen: Sharing violation“, er næste handling klar: juster retry-vinduet, tjek sti/scanner, vurder locking-koncepter.

Wann sich der robuste Code nicht lohnt – und was trotzdem Pflicht bleibt

Der findes projekter, hvor en komplet Replace/Flush-sti er uforholdsmæssig: enkeltbruger-værktøj, konfigurationen er rent kosmetisk, skrivninger er sjældne, og et reset er acceptabelt. Så kan „normal speichern“ være acceptabelt.

To ting bør du også ikke undlade:

  • Gendannelse ved indlæsning: Hvis INI ikke kan parses, må der ikke ske et hårdt stop. Sæt standardværdier, eventuelt lav en sikkerhedskopi af den beskadigede fil og skriv den på ny.
  • Minimal validering: Kontroller obligatoriske sektioner og obligatoriske nøgler, så „halvt plausibelt“ ikke fører til efterfølgende fejl, som senere fejltolkes som netværks- eller databaseproblem.

Dette er den egentlige effektivitetsgevinst: De forhindrer, at en beskadiget tekstfil bliver til en driftsforstyrrelse – uanset om De allerede har implementeret den mest robuste skrivevej.

Første trin: Kort tjekliste til beslutning i teamet

  • Kan processen blive hårdt afbrudt under gemmeoperationen? (Service-Shutdown, Update, Kiosk) Hvis ja: Planlæg Replace-mønster.
  • Er konfigurationen startkritisk? Hvis ja: udskift atomisk og forudse en backupmulighed.
  • Ligger filen virkelig lokalt på NTFS? Hvis nej: testindsatsen stiger, mønsteret er dog stadig fornuftigt.
  • Findes der flere skrivere? Hvis ja: design også locking/serialisering.
  • Er fejlforløb synlige? Hvis nej: tilføj først logging på trinniveau.

Hvis De besvarer to eller flere punkter med „ja“, er sandsynligheden høj for, at De ved en atomisk udskiftning sparer Dem for tickets, som ellers kun optræder sporadisk – og derfor er særligt dyre.

Afrunding: Atomisk opdatering betyder at tage driften med i betragtningen

INI-filer er små, men deres effekt er det ofte ikke. Et robust mønster for „Delphi: INI/Config atomar aktualisieren“ er ikke luksus: Temp-fil i målmappen, Flush/Write-through der, hvor det tæller, og en atomisk udskiftning (typisk ReplaceFileW) plus gennemskuelige fejlfelter. Dermed har De i en alvorlig situation ikke kun en intakt fil, men også et svar på supportspørgsmålet „Hvad skete der præcist?“

Hvis De ønsker at gennemføre mønsteret i det eksisterende miljø (inklusive teststrategi, locking-koncept og migrationssti for flere konfigurationssteder), kan det hurtigst afklares i en kort teknisk afstemning: Tag kontakt.

Kilder og yderligere information

De faglige kerneudsagn er redaktionelt sat i perspektiv på baggrund af følgende eksterne kilder.

  1. Flushing System-Buffered I/O Data to Disk – Win32 apps | Microsoft Learn (learn.microsoft.com)
    Windows bufferer filskrivninger; uden eksplicit flush bestemmer cachealgoritmer, hvornår data faktisk lander på lagermediet, hvorfor FlushFileBuffers er relevant for persistente skriveoperationer.
  2. CreateFileA function (fileapi.h) – Win32 apps | Microsoft Learn (learn.microsoft.com)
    FILE_FLAG_WRITE_THROUGH beskriver write-through-adfærd ved CreateFile; for metadatas holdbarhed henvises der stadig til FlushFileBuffers.
  3. ReplaceFileW function (winbase.h) – Win32 apps | Microsoft Learn (learn.microsoft.com)
    ReplaceFileW indkapsler udskiftningen af en fil og forudsætter, at den udskiftede fil og erstatningsfilen ligger på samme volume.
  4. System.IniFiles.TIniFile.UpdateFile – RAD Studio API Documentation (docwiki.embarcadero.com)
    TIniFile.UpdateFile dokumenteres som en Flush af buffrede ændringer og perspektiveres historisk/kontekstuelt i forhold til NT-systemer.

Til dette emne er også Atomar filudskiftning og Replacefilew Delphi vigtige. Indlægget sætter disse aspekter i en klar kontekst og viser, hvad der er afgørende i daglig praksis.

Drøft projekt eller moderniseringsprojekt med Net-Base.

Næste trin

Når emnet bliver til et reelt projekt, bør arkitektur, eksisterende systemer og drift tidligt vurderes samlet.

Vi støtter ikke kun ved enkeltspørsmål, men også når kildekodeudsnit, legacy-komponenter eller portalidéer skal udvikles til et robust virksomhedsprojekt.

  • Eksisterende tilstand, målbillede og tekniske risici vurderes samlet.
  • REST, dataadgang, portaler og udrulning bliver ikke udskudt som efterfølgende opgaver.
  • De ser tidligt, hvilken vej der er økonomisk og driftsmæssigt bæredygtig.

Del indlæg

Del dette indlæg direkte

LinkedIn, X, Facebook, WhatsApp und E-Mail sind sofort verfügbar. für Instagram bereiten wir Link und Kurztext direkt vor.

E-mail

Instagram åbner i en ny fane. Linket og kortteksten kopieres på forhånd til udklipsholderen.

Skriv kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert