When your Python program writes to a file, the return of that function call is not a guarantee of storage; it is merely an acknowledgment of receipt. As developers, we rely on high-level abstractions to mask the complex realities of hardware. We write code that feels deterministic and instantaneous, often assuming that a successful function call equates to physical permanence. not a guarantee of storage Consider this simple Python snippet serving a role in a transaction processing system: transaction_id = "TXN-987654321"
# Open a transaction log in text mode
with open("/var/log/transactions.log", "a") as log_file:
    # Write the commitment record
    log_file.write(f"COMMIT: {transaction_id}\n")
    print("Transaction recorded") transaction_id = "TXN-987654321"
# Open a transaction log in text mode
with open("/var/log/transactions.log", "a") as log_file:
    # Write the commitment record
    log_file.write(f"COMMIT: {transaction_id}\n")
    print("Transaction recorded") When that print statement executes, the application resumes, operating under the assumption that the data is safe. However, the data has not hit the disk. It hasn't even hit the filesystem. It has merely begun a complex relay race across six distinct layers of abstraction, each with its own buffers and architectural goals. print In this article, we will describe the technical lifecycle of that data payload namely, the string "COMMIT: TXN-987654321\n" as it moves from Python user space down to the silicon of the SSD. "COMMIT: TXN-987654321\n" [Layer 1]: User Space (Python & Libc) The Application Buffer Our journey begins in the process memory of the Python interpreter. When you call file.write() on a file opened in text mode, Python typically does not immediately invoke a system call. Context switches to the kernel are expensive. Instead, Python employs a user-space buffer to accumulate data. By default, this buffer is 8KB in size, chosen specifically to align with the memory page size of the underlying operating system. file.write() Our data payload sits in this RAM buffer. It is owned entirely by the Python process. If the application terminates abruptly, perhaps due to a SIGKILL signal or a segmentation fault, the data is lost instantly. It never left the application's memory space. SIGKILL The Flush and The Libc Wrapper The with statement concludes and triggers an automatic .close(). This subsequently triggers a .flush(). Python now ejects this data and passes the payload down to the system's C standard library, such as glibc on Linux. libc acts as the standardized interface for the kernel. While C functions like fwrite manage their own user-space buffers, Python's flush operation typically calls the lower-level write(2) function directly. libc sets up the CPU registers with the file descriptor number, the pointer to the buffer, and the payload length. It then executes a CPU instruction, such as SYSCALL on x86-64 architectures, to trap into the kernel. with .close() .flush() glibc libc fwrite write(2) function libc SYSCALL At this point, we cross the boundary from User Space into Kernel Space. [Layer 2]: The Kernel Boundary (VFS) The CPU switches to privileged mode. The Linux kernel handles the interrupt, checks the CPU registers, and identifies a request to write to a file descriptor. It hands the request to the Virtual File System (VFS). The VFS serves as the kernel's unification layer. It provides a consistent API for the system regardless of whether the underlying storage is Ext4, XFS, NFS, or a RAM disk. Virtual File System (VFS) The VFS performs initial validity checks, such as verifying permissions and file descriptor status. It then uses the file descriptor to locate the specific filesystem driver responsible for the path, which in this case is Ext4. The VFS invokes the write operation specific to that driver. [Layer 3]: The Page Cache (Optimistic I/O) We have arrived at the performance center of the Linux storage stack: the Page Cache. Page Cache In Linux, file I/O is fundamentally memory-mapped. When the Ext4 driver receives the write request, it typically does not initiate immediate communication with the disk. Instead, it prepares to write to the Page Cache. The Page Cache is a section of system RAM dedicated to caching file data. It should be noted that Ext4 generally delegates the actual Page Cache related memory operations back to the generic kernel memory management subsystem. What happens next is memory-mapped dedicated to caching file data The kernel manages memory in fixed-size units called pages (typically 4KB on standard Linux configurations). Because our transaction log payload is small ("COMMIT: TXN-987654321\n"), it fits entirely within a single page. The kernel allocates (or locates) the specific 4KB page of RAM that corresponds to the file's current offset.
It copies the data payload into this memory page.
It marks this page as "dirty". A dirty page implies that the data in RAM is newer than the data on the persistent storage. The kernel manages memory in fixed-size units called pages (typically 4KB on standard Linux configurations). Because our transaction log payload is small ("COMMIT: TXN-987654321\n"), it fits entirely within a single page. The kernel allocates (or locates) the specific 4KB page of RAM that corresponds to the file's current offset. pages "COMMIT: TXN-987654321\n" It copies the data payload into this memory page. It marks this page as "dirty". A dirty page implies that the data in RAM is newer than the data on the persistent storage. "dirty" The Return: Once the data is copied into RAM, the write(2) system call returns SUCCESS to libc, which returns to Python. Crucially, the application receives a success signal before any physical I/O has occurred. The kernel prioritizes throughput and latency over immediate persistence, deferring the expensive disk operation to a background process. The data is currently vulnerable to a kernel panic or power loss. The Return: write(2) SUCCESS libc before before prioritizes throughput and latency over immediate persistence [Layer 4]: The Filesystem (Ext4 & JBD2) The data may reside in the page cache for a significant duration. Linux default settings allow dirty pages to persist in RAM for up to 30 seconds. Eventually, a background kernel thread initiates the writeback process to clean these dirty pages. The Ext4 filesystem must now persist the data. It must also update the associated metadata, such as the file size and the pointers to the physical blocks on the disk. These metadata structures initially exist only in the system memory. To prevent corruption during a crash, Ext4 employs a technique called Journaling. Ext4 filesystem Before the filesystem permanently updates the file structure, Ext4 interacts with its journaling layer, the JBD2 (Journaling Block Device). Ext4 typically operates in a mode called "ordered journaling." It orchestrates the operation by submitting distinct write requests to the Block Layer (Layer 5 - next section) in a specific sequence. JBD2 (Journaling Block Device) Step 1: The Data Write. First, Ext4 submits a request to write the actual data content to its final location on the disk. This ensures that the storage blocks contain valid information before any metadata pointers reference them.
Step 2: The Journal Commit. Once the data write is finished, JBD2 submits a write request for the metadata. It writes a description of the changes to a reserved circular buffer on the disk called the journal. This entry acts as a "commitment" that the file structure is effectively updated.
Step 3: The Checkpoint. Finally, the filesystem flushes the modified metadata from the system memory to its permanent home in the on-disk inode tables. If the system crashes before this step, the operating system can replay the journal to restore the filesystem to a consistent state. Step 1: The Data Write. First, Ext4 submits a request to write the actual data content to its final location on the disk. This ensures that the storage blocks contain valid information before any metadata pointers reference them. Step 1: The Data Write Step 2: The Journal Commit. Once the data write is finished, JBD2 submits a write request for the metadata. It writes a description of the changes to a reserved circular buffer on the disk called the journal. This entry acts as a "commitment" that the file structure is effectively updated. Step 2: The Journal Commit Step 3: The Checkpoint. Finally, the filesystem flushes the modified metadata from the system memory to its permanent home in the on-disk inode tables. If the system crashes before this step, the operating system can replay the journal to restore the filesystem to a consistent state. Step 3: The Checkpoint [Layer 5]: The Block Layer & I/O Scheduler The filesystem packages its pending data into a structure known as a bio (Block I/O). It then submits this structure to the Block Layer. The Block Layer serves as the traffic controller for the storage subsystem. It optimizes the flow of requests before they reach the hardware using an I/O Scheduler, such as MQ-Deadline or BFQ. If the system is under heavy load with thousands of small, random write requests, the scheduler intercepts them to improve efficiency. It generally performs two key operations. bio Block Layer I/O Scheduler I/O Scheduler Merging Requests. The scheduler attempts to combine adjacent requests into fewer, larger operations. By merging several small writes that target contiguous sectors on the disk, the system reduces the number of individual commands it must send to the device.
Reordering Requests. The scheduler also reorders the queue. It prioritizes requests to maximize the throughput of the device or to ensure fairness between different running processes. Merging Requests. The scheduler attempts to combine adjacent requests into fewer, larger operations. By merging several small writes that target contiguous sectors on the disk, the system reduces the number of individual commands it must send to the device. Merging Requests Reordering Requests. The scheduler also reorders the queue. It prioritizes requests to maximize the throughput of the device or to ensure fairness between different running processes. Reordering Requests Once the scheduler organizes the queue, it passes the request to the specific device driver, such as the NVMe driver. This driver translates the generic block request into the specific protocol required by the hardware, such as the NVMe command set transmitted over the PCIe bus. NVMe driver PCIe bus [Layer 6]: The Hardware (The SSD Controller) The payload traverses the PCIe bus and reaches the SSD. However, even within the hardware, buffering plays a critical role. Modern Enterprise SSDs function as specialized computers. They run proprietary firmware on multi-core ARM processors to manage the complex physics of data storage. The DRAM Cache and Acknowledgment. The DRAM Cache and Acknowledgment To hide the latency of NAND flash, which is slow to write compared to reading, the SSD controller initially accepts the data into its own internal DRAM cache. Once the data reaches this cache, the controller sends an acknowledgment back to the operating system that the write is complete. At this precise nanosecond, the data is still in volatile memory. It resides on the drive's printed circuit board rather than the server's motherboard. High-end enterprise drives contain capacitors to flush this cache during a sudden power loss, but consumer drives often lack this safeguard. the data is still in volatile memory Flash Translation & Erasure Flash Translation & Erasure The SSD's Flash Translation Layer (FTL) now takes over. Because NAND flash cannot be overwritten directly, it must be erased in large blocks first. The FTL determines the optimal physical location for the data to ensure even wear across the drive, a process known as wear leveling. Physical Storage Physical Storage Finally, the controller applies voltage to the transistors in the NAND die. This changes their physical state to represent the binary data. Only after this physical transformation is the data truly persistent. data truly persistent data truly persistent Conclusion: Understanding the Durability Contract The journey of a write highlights the explicit trade-off operating systems make between performance and safety. By allowing layers to buffer and defer work, systems achieve high throughput, but the definition of "written" becomes fluid. If an application requires strict data durability at the moment of completion where data loss is unacceptable, developers cannot rely on the default behavior of a write() call at the application layer. write() To guarantee persistence, one must explicitly pierce these abstraction layers using os.fsync(fd). This Python call invokes the fsync system call (in Linux based systems) which forces a flush of the dirty pages to the filesystem, commits the journal, dispatches the block I/O, and issues a standard "Flush Cache" command to the storage controller, demanding the hardware empty its volatile buffers onto the NAND. Only when fsync returns has the journey truly ended. os.fsync(fd) call fsync fsync fsync fsync

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

The code in this story is for educational purposes. The readers are solely responsible for whatever they build with it.

The Anatomy of a Write Operation

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Markdown For What? or Why Do We Want Markdown In Our Text Editor?

The Psychology of Mobile Ads: What Drives Clicks and Conversions?

The Easiest Way to Integrate Coz.jp Into Your Workflows: Exploring the n8n Node

222 Stories To Learn About Algorithms

30 Days DSA Interview Preparation Plan

4 Tips To Become A Successful Entry-Level Data Analyst

Markdown For What? or Why Do We Want Markdown In Our Text Editor?

The Psychology of Mobile Ads: What Drives Clicks and Conversions?

The Easiest Way to Integrate Coz.jp Into Your Workflows: Exploring the n8n Node

222 Stories To Learn About Algorithms

30 Days DSA Interview Preparation Plan

4 Tips To Become A Successful Entry-Level Data Analyst

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps