Escape a string so it can be a shell argument.

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. cmd can be a format string as in Printf.

• parameter stdin

  if provided, the generator or string is consumed and fed to the subprocess input channel, which is then closed.

• parameter bufsize

  buffer size used to read stdout and stderr.

• parameter env

  environment to run the command in.

Example:

  # CCUnix.call_full "ls %s" (CCUnix.escape_str "/");;

call cmd is similar to call_full but returns a tuple stdout, stderr, errcode instead of an object.

A subprocess for interactive usage (read/write channels line by line)

• since 0.11

Spawns a subprocess, like call, but the subprocess's channels are line generators and line sinks (for stdin). If p is async_call "cmd", then p#wait waits for the subprocess to die. Channels can be closed independently.

• since 0.11

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.

• parameter flags

  opening flags. Unix.O_RDONLY is used in any cases.

• since 0.16

Same as with_in but for an output channel.

• parameter flags

  opening flags (default [Unix.O_CREAT; Unix.O_TRUNC]) Unix.O_WRONLY is used in any cases.

• since 0.16

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;;

• since 0.16

Open a shell command in a subprocess and obtain a handle to its stdin.

• since 0.16

Handle to a subprocess.

• since 0.16

Open a subprocess and obtain a handle to its channels.

• parameter env

  environment to pass to the subprocess.

• since 0.16

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.

• since 2.8

Wrap Unix.open_connection with a handler.

• since 0.16

Listen on the address and calls the handler in a blocking fashion. Using Thread is recommended if handlers might take time. The callback should raise ExitServer to stop the loop.

• since 0.16

with_file_lock ~kind filename f puts a lock on the offset 0 of the file named filename, calls 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.

• parameter kind

  specifies whether the lock is read-only or read-write.

• since 1.2

Create a temporary directory, call the function, and then destroy the directory afterwards. Usage with_temp_dir pattern f.

• parameter pattern

  the naming pattern for the temporary directory. Helps avoiding collisions.

• parameter mode

  mode for the directory

• parameter dir

  the directory under which to make a temporary directory (default /tmp)

Note that this is implemented following the discussion at: https://discuss.ocaml.org/t/how-to-create-a-temporary-directory-in-ocaml/1815/

• since 2.8