Some useful functions built on top of Unix.
type 'a or_error = ( 'a, string ) result
type call_result = < stdout : string ; stderr : string ; status : Unix.process_status ; errcode : int >
val call_full : ?bufsize:int -> ?stdin:[ `Gen of string gen | `Str of string ] -> ?env:string array -> ( 'a, Buffer.t, unit, call_result ) format4 -> 'a
call_full cmd wraps the result of
Unix.open_process_full cmd into an object. It reads the full stdout and stderr of the subprocess before returning.
val call : ?bufsize:int -> ?stdin:[ `Gen of string gen | `Str of string ] -> ?env:string array -> ( 'a, Buffer.t, unit, string * string * int ) format4 -> 'a
call cmd is similar to
call_full cmd but returns a tuple
stdout, stderr, errcode instead of an object.
type async_call_result = < stdout : line gen ; stderr : line gen ; stdin : line -> unit ; close_in : unit ; close_err : unit ; close_out : unit ; close_all : unit ; wait : Unix.process_status ; wait_errcode : int >
A subprocess for interactive usage (read/write channels line by line)
Spawns a subprocess, like
call, but the subprocess's channels are line generators and line sinks (for stdin). If
async_call "cmd", then
p#wait waits for the subprocess to die. Channels can be closed independently.
Open an input file with the given optional flag list, calls the function on the input channel. When the function raises or returns, the channel is closed.
with_in but for an output channel.
val with_process_in : string -> f:( in_channel -> 'a ) -> 'a
Open a shell command in a subprocess and obtain a handle to its stdout.
CCUnix.with_process_in "ls /tmp" ~f:CCIO.read_lines_l;;
val with_process_out : string -> f:( out_channel -> 'a ) -> 'a
Open a shell command in a subprocess and obtain a handle to its stdin.
type process_full = < stdin : out_channel ; stdout : in_channel ; stderr : in_channel ; close : Unix.process_status >
Handle to a subprocess.
val with_process_full : ?env:string array -> string -> f:( process_full -> 'a ) -> 'a
Open a subprocess and obtain a handle to its channels.
On unix, call
Unix.setsid() to make sure subprocesses die at the same time as the current process. Does nothing on windows. Idempotent: it can be called several times but will only have effects, if any, the first time.
Unix.open_connection with a handler.
with_file_lock ~kind filename f puts a lock on the offset 0 of the file named
f and returns its result after the file is unlocked. If
f () raises an exception the exception is re-raised after the file is unlocked.
module Infix : sig ... end