ganeti.utils.io

Converts bytes to mebibytes.

Calculates the size of a directory recursively.

Returns True if the user can access (read) the file.

Creates a backup of a file.

Compute a ganeti pid file absolute path

Enforces that given path has given permissions.

Make required directories, if they don't exist.

Format an EnvironmentError exception.

If the err argument has an errno attribute, it will be looked up and converted into a textual E... description. Otherwise the string representation of the error will be returned.

Look for a filesystem object in a given path.

This is an abstract method to search for filesystem object (files, dirs) under a given search path.

Returns the file 'id', i.e. the dev/inode and mtime information.

Either the path to the file or the fd must be given.

Returns the total and free space on a filesystem.

Check whether a path is below a root dir.

This works around the nasty byte-byte comparison of commonprefix.

Check whether a path is absolute and also normalized

This avoids things like /dir/../../other/path to be valid.

Check whether a path is a HTTP URL.

Returns True if the user belongs to the group.

Returns a list of visible files in a directory.

Super-mkdir; create a leaf directory and all intermediate ones.

This is a wrapper around os.makedirs adding error handling not implemented before Python 2.5.

Enforces that given path is a dir and has given mode, uid and gid set.

Returns a random UUID.

Returns a text I/O object pointing a TTY (/dev/tty by default)

As of Python 3.7, /dev/tty cannot be opened in buffered and/or text mode, see https://bugs.python.org/issue20074. Work around this by using TextIOWrapper over a BufferedRWPair to return a line-buffered TTY I/O object.

Safe-join a list of path components.

Requirements:

• the first argument must be an absolute path
• no component in the path must have backtracking (e.g. /../), since we check for normalization at the end

Reads a binary file.

Reads a text file.

Reads a locked PID file.

This can be used together with utils.process.StartDaemon.

Return the first non-empty line from a file.

Read a pid from a file.

Reads the watcher pause file.

Remove an empty directory.

Remove a directory, ignoring non-existing ones. Other errors are passed. This includes the case, where the directory is not empty, so it can't be removed.

Remove a file ignoring some errors.

Remove a file, ignoring non-existing ones or directories. Other errors are passed.

Renames a file.

This just creates the very least directory if it does not exist and mkdir is set to true.

Wraper over WriteFile that locks the target file.

By keeping the target file locked during WriteFile, we ensure that cooperating writers will safely serialise access to the file.

Return the last lines from a file.

Returns the current time formatted for filenames.

The format doesn't contain colons as some shells and applications treat them as separators. Uses the local timezone.

Verifies that two file IDs are matching.

Differences in the inode/device are not accepted, but and older timestamp for fi_disk is accepted.

(Over)write a file atomically.

The file_name and either fn (a function taking one argument, the file descriptor, and which should write the data to it) or data (the contents of the file) must be passed. The other arguments are optional and allow setting the file mode, owner and group, and the mtime/atime of the file.

If the function doesn't raise an exception, it has succeeded and the target file has the new contents. If the function has raised an exception, an existing target file should be unmodified and the temporary file should be removed.

Write the current process pidfile.