{"id":7711,"date":"2026-08-08T00:01:33","date_gmt":"2026-08-08T07:01:33","guid":{"rendered":"https:\/\/c-for-dummies.com\/blog\/?p=7711"},"modified":"2026-08-01T12:41:21","modified_gmt":"2026-08-01T19:41:21","slug":"rubbing-a-file-raw","status":"publish","type":"post","link":"https:\/\/c-for-dummies.com\/blog\/?p=7711","title":{"rendered":"Rubbing a File Raw"},"content":{"rendered":"

About six years ago, I wrote about opening a file in the raw<\/a>. Specifically, using the open()<\/em> function to access file data at a low level. This approach uses file descriptors (integers) to track file I\/O as opposed to the file handles used by the high-level fopen()<\/em> family of functions. It turns out that you can do more with raw file access than just read and write data.
\n
\nThe following code provides an example of raw file access. It creates a file test.txt<\/code> and writes the word “Hello!” to the file. The operations follow the same order as when using formatted file I\/O: The file is opened. Data is written to the file. The file is closed. These functions — open()<\/em>, write()<\/em>, and close()<\/em> — use an integer file descriptor as their reference, not a file handle.<\/p>\n

2026_08_08-Lesson.c<\/a><\/h3>\n
\r\n#include <stdio.h>\r\n#include <fcntl.h>\r\n#include <unistd.h>\r\n#include <stdlib.h>\r\n\r\nint main()\r\n{\r\n    char filename[] = \"test.txt\";\r\n    int fd;\r\n    mode_t filemode = O_CREAT | O_WRONLY;\r\n\r\n    \/* open\/create the file *\/<\/span>\r\n    fd = open(filename,filemode);\r\n    if( fd==-1 )\r\n    {\r\n        fprintf(stderr,\"Unable to create %s\\n\",filename);\r\n        perror(\"ERROR: \");\r\n        exit(1);\r\n    }\r\n\r\n    \/* write data to the file *\/<\/span>\r\n    write(fd,\"Hello!\\n\",8);\r\n\r\n    \/* clean-up *\/<\/span>\r\n    close(fd);\r\n    return 0;\r\n}<\/pre>\n
The open()<\/em> function returns a file descriptor value, saved in int<\/em> variable fd<\/code>. If the value returned is -1, some sorta error happened, in which case appropriate messages are output and the program exits.<\/p>\n
The file is opened with two modes applied, saved in mode_t<\/em> variable filemode<\/code>:<\/p>\n
O_CREAT<\/code> creates the file if it doesn’t exist.<\/p>\n
O_WRONLY<\/code> opens the file for writing only.<\/p>\n
Upon opening\/creating the file successfully, the write()<\/em> function sends the string \"Hello!\\n\"<\/code> to the file; the function requires the file descriptor number, string, and the number of bytes to write: write(fd,\"Hello!\\n\",8);<\/code> The value 8 includes all characters in the string, plus the terminating null character.<\/p>\n
After the close()<\/em> function closes the file, the program ends. No output is generated. To confirm that everything worked, use the ls<\/em> command in a terminal window. Better, cat<\/em> the file to check its contents:<\/p>\n
$ cat test.txt\r\nHello!<\/pre>\n
This code successfully wrote the text Hello (newline)<\/em> to a file, test.txt<\/code>, which it created. But keep in mind that the open()<\/code> function is directed to open\/create the file. This effect has unusual consequences when you’re not careful.<\/p>\n
Change the string in the write()<\/em> function to read \"X\\n\"<\/code> and set the number of bytes to write to 3:<\/p>\n
write(fd,\"X\\n\",3);<\/code><\/p>\n
Rebuild and re-run the program, and then examine the contents of the test.txt<\/code> file to see the following:<\/p>\n
$ cat test.txt\r\nX\r\nllo<\/pre>\n
The O_CREAT<\/code> flag creates or opens a file, but any existing file isn’t destroyed nor is any data deleted. Further, the file position indicator is set to zero when the file is opened. The effect is that any new information written to the file overwrites what’s already there.<\/p>\n
To remedy this situation, and to have the open()<\/em> function overwrite an existing file, add the O_TRUNC<\/code> mode at Line 10:<\/p>\n
mode_t filemode = O_CREAT | O_WRONLY | O_TRUNC;<\/code><\/p>\n
Running this update, creates a file test.txt<\/code> that only contains the new data written to it. The O_TRUNC<\/code> flag resizes the file to zero as it’s opened, removing any existing contents.<\/p>\n
As an alternative, you can use the creat()<\/em> function instead of open()<\/em>. This function works identically to the open()<\/em> function with the O_CREAT<\/code>, O_WRONLY<\/code>, and O_TRUNC<\/code> flags specified. Update the code to replace open()<\/em> with this statement:<\/p>\n
fd = creat(filename,0);<\/code><\/p>\n
And remove the statement declaring mode_t<\/em> variable filemode<\/code> to avoid an unused variable warning.<\/p>\n
The updated program creates a new file to replace any existing file.<\/p>\n
Yes, you can always surrender and use fopen()<\/em> instead of open()<\/em>. Life is easier that way. But then you’ll never discover the wonders of the dup()<\/em> function, which I cover in next week’s Lesson.<\/p>\n","protected":false},"excerpt":{"rendered":"
Raw file access uses file descriptors, which have some interesting properties. Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-7711","post","type-post","status-publish","format-standard","hentry","category-main"],"_links":{"self":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/7711","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=7711"}],"version-history":[{"count":3,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/7711\/revisions"}],"predecessor-version":[{"id":7717,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/7711\/revisions\/7717"}],"wp:attachment":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=7711"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=7711"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=7711"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}