Exception raised when subprocess fails

raise Process_error

raise Process_error if the process didn't return 0

Exception raised when a computation in the current process fails.

Raise Internal_error

with_tmp_dir fn executes fn in a tempory directory

Runs a job with a temp dir that is cleaned up afterwards

Returns true if the default verbose level for base commands (cp, mv, etc.) is reached

Returns a directory name, in the temporary directory, composed by opam (if prefix is not set), pid, and random number.

copy_file src dst copies src to dst. Remove dst before the copy if it is a link.

copy_dir src dst copies the contents of directory src into directory dst, creating it if necessary, merging directory contents and ovewriting files otherwise

install ?exec src dst copies file src as file dst using install. If exec, make the resulting file executable (otherwise, look at the permissions of the original file to decide).

Checks if a file is an executable (regular file with execution permission)

link src dst links src to dst. Remove dst if it is a file, not a directory.

real_path p returns the real path associated to p: .. are expanded and relative paths become absolute.

Return the contents of a channel.

Raised when a file or directory can't be accessed (doesn't exist, bad permissions, etc.)

read filename returns the contents of filename (while taking an advisory read lock to prevent concurrent writes)

write filename contents write contents to filename (while taking an advisory write lock to prevent concurrent reads or writes)

remove filename removes filename. Works whether filename is a file or a directory

remove_file filename removes filename. Works only for normal files (or also at least for symlinks)

remove_dir filename removes filename. Works only for directory (not for symlinks or other files).

Change the current working directory

in_dir dir fn evaluates fn in the directory dir

Returns the list of files and directories in the given directory (full names)

files_with_links dir returns the files in the directory dir. Links simulating directory are ignored, others links are returned.

rec_files dir returns the list of all files in dir, recursively. Links behaving like directory are crossed.

Return the list of files in the current directory.

rec_dirs dir return the list list of all directories recursively (going through symbolink links).

Return the list of directories in the current directory.

directories_with_links dir returns the directories in the directory dir. Links pointing to directory are also returned.

Make a comman suitable for OpamProcess.Job. if verbose, is set, command and output will be displayed (at command end for the latter, if concurrent commands are running). name is used for naming log files. text is what is displayed in the status line for this command. May raise Command_not_found, unless resolve_path is set to false (in which case you can end up with a process error instead)

a command is a list of words

Test whether a command exists in the environment, and returns it (resolved if found in PATH)

command cmd executes the command cmd in the correct OPAM environment.

commands cmds executes the commands cmds in the correct OPAM environment. It stops whenever one command fails unless keep_going is set to true. In this case, the first error is re-raised at the end.

read_command_output cmd executes the command cmd in the correct OPAM environment and return the lines from stdout if the command exists normally. If the command does not exist or if the command exited with a non-empty exit-code, throw an error.

Test whether the file is an archive, by looking as its extension

extract ~dir:dirname filename extracts the archive filename into dirname. dirname should not exists and filename should contain only one top-level directory.

Same as extract, but as an OpamProcess.job

extract_in ~dir:dirname filename extracts the archive filename into dirname.

extract_in_job is similar to extract_in, but as a job

Create a directory. Do not fail if the directory already exist.

Get the number of active processors on the system

Unix file locks (mutable structure, to follow actual semantics)

The different kinds of unix advisory locks available (`Lock_none doesn't actually lock anything, or even create the lock file)

Dummy lock

Raised when locks can't be acquired and dontblock was specified)

Force releases all open locks in the process. Required for Windows if an exception has been raised, since Windows doesn't permit unlinking while handles are open.

Acquires a lock on the given file. Raises Locked if the lock can't be acquired and dontblock is set. Raises OpamStd.Sys.Exit if safe_mode is set and a write lock is required. Also raises Unix errors if the lock file can't be opened.

Updates an existing lock to the given level. Raises the same exceptions as flock.

Releases an acquired lock (equivalent to flock_update `Lock_none)

Returns the highest of the two lock flags (with the order no lock < read lock < write lock)

Returns true if the lock already has the lock_flag rights or more

Returns the current kind of the lock

Returns the underlying fd for the lock or raises Not_found for `No_lock

Apply a patch file in the current directory. If preprocess is set to false, there is no CRLF translation. Returns the error if the patch didn't apply.

Create a temporary file in ~/.opam/logs/<name>XXX, if dir is not set. ?auto_clean controls whether the file is automatically deleted when opam terminates (default: true).

Print stats

Registers an exception printer that adds some OPAM version info, and details on process and Unix errors

Initialises signal handlers, catch_break and some exception printers. The lib may not perform properly without this if Sys.catch_break isn't set and SIGPIPE isn't handled (with a no-op)

On Unix, a no-op. On Windows, convert / to \

On Unix, a no-op. On Windows, convert \ to /