ac685fbe2ff1307b2876a23a1b39b7a3355ee48f
[libjh.git] / io.c
1 // Copyright (2013) Jann Horn <jann@thejh.net>
2 // This code is licensed under the AGPLv3.
3
4 HEADER #include <sys/types.h>
5 #include <unistd.h>
6 #include <errno.h>
7 #include <stdlib.h>
8 #include <stdbool.h>
9 #include <sys/stat.h>
10 #include <fcntl.h>
11 #include <string.h>
12 #include <assert.h>
13 #include <sys/mman.h>
14
15 // Wrapper for `read` that retries on partial reads.
16 // If last_res is non-NULL, it will be filled with the
17 // result of the last read() call (but all positive numbers
18 // become 1). In other words:
19 //  - -1: error
20 //  - 0: stream ended
21 //  - 1: no problems occured
22 PUBLIC_FN ssize_t read_nointr(int fd, void *buf, size_t count, int *last_res) {
23   errno = 0;
24   size_t done = 0;
25   while (done < count) {
26     ssize_t part_res = read(fd, buf+done, count-done);
27     if (part_res <= 0) {
28       if (last_res) *last_res = part_res;
29       if (done) return done;
30       return part_res;
31     }
32     done += part_res;
33   }
34   if (last_res) *last_res = 1;
35   return done;
36 }
37
38 // Wrapper for `write` that retries on partial writes.
39 // If last_res is non-NULL, it will be filled with the
40 // result of the last write() call (but all positive numbers
41 // become 1). In other words:
42 //  - -1: error
43 //  - 0: stream ended
44 //  - 1: no problems occured
45 PUBLIC_FN ssize_t write_nointr(int fd, void *buf, size_t count, int *last_res) {
46   errno = 0;
47   size_t done = 0;
48   while (done < count) {
49     ssize_t part_res = write(fd, buf+done, count-done);
50     if (part_res <= 0) {
51       if (last_res) *last_res = part_res;
52       if (done) return done;
53       return part_res;
54     }
55     done += part_res;
56   }
57   if (last_res) *last_res = 1;
58   return done;
59 }
60
61 // Read all data from the given file descriptor. Tries fstat()+read()
62 // first, but if fstat() doesn't work, falls back to multiple read()s.
63 // Specify JH_NO_STAT to prevent the fstat() call.
64 // The return value is a malloc'd buffer.
65 // The buffer will be null-terminated, so you can read text files with
66 // this and can specify len_out as NULL.
67 PUBLIC_CONST JH_SLURP_NO_STAT 1
68 PUBLIC_CONST JH_SLURP_REALLOC 2 /* realloc result block if it saves RAM */
69 PUBLIC_CONST JH_SLURP_8BYTE_PAD 4 /* pad buffer with eight nullbytes, not one */
70 PUBLIC_FN char *slurp_fd(int fd, size_t *len_out, int flags) {
71   int errno_;
72   
73   // Let's just guess that the file is 1023 bytes. Will become 1024 with
74   // the nullbyte.
75   size_t size_guess = 1023;
76   bool trusted_guess = false; /* can we rely on the guess? */
77   
78   int padlen = (flags&JH_SLURP_8BYTE_PAD)?8:1;
79   
80   // If we can determine the exact size, we don't have to guess. So try
81   // to determine the exact size.
82   if (!(flags&JH_SLURP_NO_STAT)) {
83     struct stat st;
84     if (fstat(fd, &st) == 0) {
85       if (st.st_size > 0) {
86         size_guess = st.st_size;
87         trusted_guess = true;
88       }
89     }
90   }
91   
92   char *buf = NULL;
93   int done = 0;
94   
95   while (1) {
96     buf = realloc(buf, size_guess+padlen);
97     if (buf == NULL) return NULL;
98     int last_res;
99     ssize_t read_res = read_nointr(fd, buf+done, size_guess-done, &last_res);
100     if (last_res == -1) { errno_=errno; free(buf); errno=errno_; return NULL; }
101     done += read_res;
102     if (last_res == 0 || trusted_guess) {
103       // out
104       if (padlen == 1) {
105         buf[done] = '\0';
106       } else {
107         *(uint64_t*)(buf+done) = 0;
108       }
109       if (done != size_guess && (flags&JH_SLURP_REALLOC)) {
110         // Well, it'd be weird if shrinking could fail... but meh, I can't find
111         // an explicit statement about this being disallowed, so try staying on
112         // the safe side.
113         char *buf_ = realloc(buf, done+padlen);
114         if (buf_) buf = buf_;
115       }
116       if (len_out) *len_out = done;
117       return buf;
118     }
119     size_guess<<=1; // try two times the buffer size
120   }
121 }
122
123 PUBLIC_FN char *slurp_file(char *path, size_t *len_out, int flags) {
124   int fd = open(path, O_RDONLY|O_CLOEXEC);
125   if (fd == -1) return NULL;
126   char *res = slurp_fd(fd, len_out, flags);
127   int errno_ = errno;
128   close(fd);
129   errno = errno_;
130   return res;
131 }
132
133 // Write data into a file. len can be -1; that means that
134 // the real length is strlen(buf).
135 PUBLIC_FN int write_file(char *path, char *buf, ssize_t len, int open_flags) {
136   if (len == -1) len = strlen(buf);
137   
138   int fd = open(path, open_flags|O_CLOEXEC|O_WRONLY, 0777);
139   if (fd == -1) return 1;
140   ssize_t write_res = write_nointr(fd, buf, len, NULL);
141   int write_errno = errno;
142   int close_res = close(fd);
143   if (write_res != len) {
144     errno = write_errno;
145     return 1;
146   }
147   if (close_res) return 1;
148   return 0;
149 }
150
151 PUBLIC_FN void *mmap_file(void *addr, size_t length, int prot, int flags, char *path, off_t offset) {
152   assert((flags&MAP_ANONYMOUS) == 0);
153   assert(prot&(PROT_EXEC|PROT_READ|PROT_WRITE));
154   int open_flags = O_CLOEXEC;
155   if ((prot & (PROT_READ|PROT_EXEC)) && !(prot&PROT_WRITE)) open_flags |= O_RDONLY;
156   else if ((prot & (PROT_READ|PROT_EXEC))) open_flags |= O_RDWR;
157   else open_flags |= O_WRONLY;
158   int fd = open(path, open_flags);
159   if (fd == -1) return NULL;
160   void *r = mmap(addr, length, prot, flags, fd, offset);
161   int errno_ = errno;
162   close(fd);
163   errno = errno_;
164   return (r==MAP_FAILED) ? NULL : r;
165 }