1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2025-02-22 14:11:27 +00:00

BackupOSError documentation

This commit is contained in:
Marian Beermann 2016-07-03 23:58:12 +02:00
parent 7db952ab7f
commit 93f4b09d41
No known key found for this signature in database
GPG key ID: 9B8450B91D1362C1

View file

@ -47,7 +47,15 @@
class BackupOSError(Exception): class BackupOSError(Exception):
"""Wrapper for OSError raised while accessing input files.""" """
Wrapper for OSError raised while accessing backup files.
Borg does different kinds of IO, and IO failures have different consequences.
This wrapper represents failures of input file or extraction IO.
These are non-critical and are only reported (exit code = 1, warning).
Any unwrapped IO error is critical and aborts execution (for example repository IO failure).
"""
def __init__(self, os_error): def __init__(self, os_error):
self.os_error = os_error self.os_error = os_error
self.errno = os_error.errno self.errno = os_error.errno
@ -414,7 +422,7 @@ def extract_item(self, item, restore_attrs=True, dry_run=False, stdout=False, sp
def restore_attrs(self, path, item, symlink=False, fd=None): def restore_attrs(self, path, item, symlink=False, fd=None):
""" """
Restore filesystem attributes on *path* from *item* (*fd*). Restore filesystem attributes on *path* (*fd*) from *item*.
Does not access the repository. Does not access the repository.
""" """