2 * Bacula low level File I/O routines. This routine simulates
3 * open(), read(), write(), and close(), but using native routines.
4 * I.e. on Windows, we use Windows APIs.
6 * Kern Sibbald, April MMIII
12 Copyright (C) 2003-2004 Kern Sibbald and John Walker
14 This program is free software; you can redistribute it and/or
15 modify it under the terms of the GNU General Public License as
16 published by the Free Software Foundation; either version 2 of
17 the License, or (at your option) any later version.
19 This program is distributed in the hope that it will be useful,
20 but WITHOUT ANY WARRANTY; without even the implied warranty of
21 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
22 General Public License for more details.
24 You should have received a copy of the GNU General Public
25 License along with this program; if not, write to the Free
26 Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
34 /* ===============================================================
36 * U N I X AND W I N D O W S
38 * ===============================================================
41 int is_win32_stream(int stream)
44 case STREAM_WIN32_DATA:
45 case STREAM_WIN32_GZIP_DATA:
51 const char *stream_to_ascii(int stream)
56 case STREAM_GZIP_DATA:
58 case STREAM_SPARSE_GZIP_DATA:
59 return "GZIP sparse data";
60 case STREAM_WIN32_DATA:
62 case STREAM_WIN32_GZIP_DATA:
63 return "Win32 GZIP data";
64 case STREAM_UNIX_ATTRIBUTES:
65 return "File attributes";
66 case STREAM_FILE_DATA:
68 case STREAM_MD5_SIGNATURE:
69 return "MD5 signature";
70 case STREAM_UNIX_ATTRIBUTES_EX:
71 return "Extended attributes";
72 case STREAM_SPARSE_DATA:
74 case STREAM_PROGRAM_NAMES:
75 return "Program names";
76 case STREAM_PROGRAM_DATA:
77 return "Program data";
78 case STREAM_SHA1_SIGNATURE:
79 return "SHA1 signature";
81 sprintf(buf, "%d", stream);
82 return (const char *)buf;
88 /* ===============================================================
92 * ===============================================================
95 #if defined(HAVE_CYGWIN) || defined(HAVE_WIN32)
97 void unix_name_to_win32(POOLMEM **win32_name, char *name);
98 extern "C" HANDLE get_osfhandle(int fd);
102 void binit(BFILE *bfd)
104 memset(bfd, 0, sizeof(BFILE));
106 bfd->mode = BF_CLOSED;
107 bfd->use_backup_api = have_win32_api();
111 * Enables using the Backup API (win32_data).
112 * Returns 1 if function worked
113 * Returns 0 if failed (i.e. do not have Backup API on this machine)
115 int set_win32_backup(BFILE *bfd)
117 /* We enable if possible here */
118 bfd->use_backup_api = have_win32_api();
119 return bfd->use_backup_api;
123 int set_portable_backup(BFILE *bfd)
125 bfd->use_backup_api = 0;
129 void set_prog(BFILE *bfd, char *prog, JCR *jcr)
136 * Return 1 if we are NOT using Win32 BackupWrite()
139 int is_portable_backup(BFILE *bfd)
141 return !bfd->use_backup_api;
146 return p_BackupRead && p_BackupWrite;
152 * Return 1 if we support the stream
153 * 0 if we do not support the stream
155 int is_stream_supported(int stream)
157 /* No Win32 backup on this machine */
160 case STREAM_GZIP_DATA:
161 case STREAM_SPARSE_GZIP_DATA:
164 case STREAM_WIN32_DATA:
165 case STREAM_WIN32_GZIP_DATA:
166 return have_win32_api();
170 case STREAM_GZIP_DATA:
171 case STREAM_SPARSE_GZIP_DATA:
173 case STREAM_UNIX_ATTRIBUTES:
174 case STREAM_FILE_DATA:
175 case STREAM_MD5_SIGNATURE:
176 case STREAM_UNIX_ATTRIBUTES_EX:
177 case STREAM_SPARSE_DATA:
178 case STREAM_PROGRAM_NAMES:
179 case STREAM_PROGRAM_DATA:
180 case STREAM_SHA1_SIGNATURE:
181 case 0: /* compatibility with old tapes */
187 HANDLE bget_handle(BFILE *bfd)
192 int bopen(BFILE *bfd, const char *fname, int flags, mode_t mode)
194 POOLMEM *win32_fname;
195 DWORD dwaccess, dwflags, dwshare;
197 /* Convert to Windows path format */
198 win32_fname = get_pool_memory(PM_FNAME);
199 unix_name_to_win32(&win32_fname, (char *)fname);
201 if (flags & O_CREAT) { /* Create */
202 if (bfd->use_backup_api) {
203 dwaccess = GENERIC_WRITE|FILE_ALL_ACCESS|WRITE_OWNER|WRITE_DAC|ACCESS_SYSTEM_SECURITY;
204 dwflags = FILE_FLAG_BACKUP_SEMANTICS;
206 dwaccess = GENERIC_WRITE;
209 bfd->fh = CreateFile(win32_fname,
210 dwaccess, /* Requested access */
212 NULL, /* SecurityAttributes */
213 CREATE_ALWAYS, /* CreationDisposition */
214 dwflags, /* Flags and attributes */
215 NULL); /* TemplateFile */
216 bfd->mode = BF_WRITE;
218 } else if (flags & O_WRONLY) { /* Open existing for write */
219 if (bfd->use_backup_api) {
220 dwaccess = GENERIC_WRITE|WRITE_OWNER|WRITE_DAC;
221 dwflags = FILE_FLAG_BACKUP_SEMANTICS;
223 dwaccess = GENERIC_WRITE;
226 bfd->fh = CreateFile(win32_fname,
227 dwaccess, /* Requested access */
229 NULL, /* SecurityAttributes */
230 OPEN_EXISTING, /* CreationDisposition */
231 dwflags, /* Flags and attributes */
232 NULL); /* TemplateFile */
233 bfd->mode = BF_WRITE;
236 if (bfd->use_backup_api) {
237 dwaccess = GENERIC_READ|READ_CONTROL|ACCESS_SYSTEM_SECURITY;
238 dwflags = FILE_FLAG_BACKUP_SEMANTICS;
239 dwshare = FILE_SHARE_READ|FILE_SHARE_WRITE|FILE_SHARE_DELETE;
241 dwaccess = GENERIC_READ;
243 dwshare = FILE_SHARE_READ|FILE_SHARE_WRITE;
245 bfd->fh = CreateFile(win32_fname,
246 dwaccess, /* Requested access */
247 dwshare, /* Share modes */
248 NULL, /* SecurityAttributes */
249 OPEN_EXISTING, /* CreationDisposition */
250 dwflags, /* Flags and attributes */
251 NULL); /* TemplateFile */
255 if (bfd->fh == INVALID_HANDLE_VALUE) {
256 bfd->lerror = GetLastError();
257 bfd->berrno = b_errno_win32;
258 errno = b_errno_win32;
259 bfd->mode = BF_CLOSED;
262 bfd->lpContext = NULL;
263 free_pool_memory(win32_fname);
264 return bfd->mode == BF_CLOSED ? -1 : 1;
268 * Returns 0 on success
271 int bclose(BFILE *bfd)
276 free_pool_memory(bfd->errmsg);
279 if (bfd->mode == BF_CLOSED) {
282 if (bfd->use_backup_api && bfd->mode == BF_READ) {
284 if (!bfd->lpContext && !p_BackupRead(bfd->fh,
286 (DWORD)0, /* bytes to read */
287 &bfd->rw_bytes, /* bytes read */
289 1, /* ProcessSecurity */
290 &bfd->lpContext)) { /* Read context */
291 errno = b_errno_win32;
294 } else if (bfd->use_backup_api && bfd->mode == BF_WRITE) {
296 if (!bfd->lpContext && !p_BackupWrite(bfd->fh,
298 (DWORD)0, /* bytes to read */
299 &bfd->rw_bytes, /* bytes written */
301 1, /* ProcessSecurity */
302 &bfd->lpContext)) { /* Write context */
303 errno = b_errno_win32;
307 if (!CloseHandle(bfd->fh)) {
309 errno = b_errno_win32;
311 bfd->mode = BF_CLOSED;
312 bfd->lpContext = NULL;
317 * Generate error message
320 char *xberror(BFILE *bfd)
324 FormatMessage(FORMAT_MESSAGE_ALLOCATE_BUFFER|
325 FORMAT_MESSAGE_FROM_SYSTEM,
332 strip_trailing_junk(msg);
334 bfd->errmsg = get_pool_memory(PM_FNAME);
336 pm_strcpy(bfd->errmsg, msg);
341 /* Returns: bytes read on success
345 ssize_t bread(BFILE *bfd, void *buf, size_t count)
349 if (bfd->use_backup_api) {
350 if (!p_BackupRead(bfd->fh,
355 1, /* Process Security */
356 &bfd->lpContext)) { /* Context */
357 bfd->lerror = GetLastError();
358 bfd->berrno = b_errno_win32;
359 errno = b_errno_win32;
363 if (!ReadFile(bfd->fh,
368 bfd->lerror = GetLastError();
369 bfd->berrno = b_errno_win32;
370 errno = b_errno_win32;
375 return (ssize_t)bfd->rw_bytes;
378 ssize_t bwrite(BFILE *bfd, void *buf, size_t count)
382 if (bfd->use_backup_api) {
383 if (!p_BackupWrite(bfd->fh,
388 1, /* Process Security */
389 &bfd->lpContext)) { /* Context */
390 bfd->lerror = GetLastError();
391 bfd->berrno = b_errno_win32;
392 errno = b_errno_win32;
396 if (!WriteFile(bfd->fh,
401 bfd->lerror = GetLastError();
402 bfd->berrno = b_errno_win32;
403 errno = b_errno_win32;
407 return (ssize_t)bfd->rw_bytes;
410 int is_bopen(BFILE *bfd)
412 return bfd->mode != BF_CLOSED;
415 off_t blseek(BFILE *bfd, off_t offset, int whence)
417 /* ****FIXME**** this must be implemented if we want to read Win32 Archives */
421 #else /* Unix systems */
423 /* ===============================================================
427 * ===============================================================
429 void binit(BFILE *bfd)
431 memset(bfd, 0, sizeof(BFILE));
437 return 0; /* no can do */
441 * Enables using the Backup API (win32_data).
442 * Returns 1 if function worked
443 * Returns 0 if failed (i.e. do not have Backup API on this machine)
445 int set_win32_backup(BFILE *bfd)
447 return 0; /* no can do */
451 int set_portable_backup(BFILE *bfd)
453 return 1; /* no problem */
457 * Return 1 if we are writing in portable format
460 int is_portable_backup(BFILE *bfd)
462 return 1; /* portable by definition */
465 void set_prog(BFILE *bfd, char *prog, JCR *jcr)
472 int is_stream_supported(int stream)
474 /* No Win32 backup on this machine */
477 case STREAM_GZIP_DATA:
478 case STREAM_SPARSE_GZIP_DATA:
480 case STREAM_WIN32_DATA:
481 case STREAM_WIN32_GZIP_DATA:
486 case STREAM_GZIP_DATA:
487 case STREAM_SPARSE_GZIP_DATA:
489 case STREAM_UNIX_ATTRIBUTES:
490 case STREAM_FILE_DATA:
491 case STREAM_MD5_SIGNATURE:
492 case STREAM_UNIX_ATTRIBUTES_EX:
493 case STREAM_SPARSE_DATA:
494 case STREAM_PROGRAM_NAMES:
495 case STREAM_PROGRAM_DATA:
496 case STREAM_SHA1_SIGNATURE:
497 case 0: /* compatibility with old tapes */
504 int bopen(BFILE *bfd, const char *fname, int flags, mode_t mode)
506 /* Open reader/writer program */
508 POOLMEM *ecmd = get_pool_memory(PM_FNAME);
509 ecmd = edit_job_codes(bfd->jcr, ecmd, bfd->prog, fname);
511 if (flags & O_RDONLY) {
516 bfd->bpipe = open_bpipe(ecmd, 0, pmode);
517 if (bfd->bpipe == NULL) {
520 free_pool_memory(ecmd);
523 free_pool_memory(ecmd);
524 if (flags & O_RDONLY) {
525 bfd->fid = fileno(bfd->bpipe->rfd);
527 bfd->fid = fileno(bfd->bpipe->wfd);
533 /* Normal file open */
534 bfd->fid = open(fname, flags, mode);
536 Dmsg1(400, "Open file %d\n", bfd->fid);
541 int bclose(BFILE *bfd)
544 Dmsg1(400, "Close file %d\n", bfd->fid);
545 if (bfd->fid == -1) {
548 /* Close reader/writer program */
549 if (bfd->prog && bfd->bpipe) {
550 stat = close_bpipe(bfd->bpipe);
557 /* Close normal file */
558 stat = close(bfd->fid);
564 ssize_t bread(BFILE *bfd, void *buf, size_t count)
567 stat = read(bfd->fid, buf, count);
572 ssize_t bwrite(BFILE *bfd, void *buf, size_t count)
575 stat = write(bfd->fid, buf, count);
580 int is_bopen(BFILE *bfd)
582 return bfd->fid >= 0;
585 off_t blseek(BFILE *bfd, off_t offset, int whence)
588 pos = lseek(bfd->fid, offset, whence);
594 char *xberror(BFILE *bfd)
596 return strerror(bfd->berrno);