path: root/Documentation
diff options
authorJonathan Tan <>2017-07-26 18:17:28 (GMT)
committerJunio C Hamano <>2017-07-26 19:56:40 (GMT)
commit7e2e1bbb24a5a0868fc83f1eddf804574f9e4b54 (patch)
treee3b2fd937f6b834e198441e4f1747ce0e530ac22 /Documentation
parent487fe1ffcd3b3a38477b7e564f235bb7d1b89ecc (diff)
Documentation: migrate sub-process docs to header
Move the documentation for the sub-process API from a separate txt file to its header file. Signed-off-by: Jonathan Tan <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation')
1 files changed, 0 insertions, 59 deletions
diff --git a/Documentation/technical/api-sub-process.txt b/Documentation/technical/api-sub-process.txt
deleted file mode 100644
index 793508c..0000000
--- a/Documentation/technical/api-sub-process.txt
+++ /dev/null
@@ -1,59 +0,0 @@
-sub-process API
-The sub-process API makes it possible to run background sub-processes
-for the entire lifetime of a Git invocation. If Git needs to communicate
-with an external process multiple times, then this can reduces the process
-invocation overhead. Git and the sub-process communicate through stdin and
-The sub-processes are kept in a hashmap by command name and looked up
-via the subprocess_find_entry function. If an existing instance can not
-be found then a new process should be created and started. When the
-parent git command terminates, all sub-processes are also terminated.
-This API is based on the run-command API.
-Data structures
-* `struct subprocess_entry`
-The sub-process structure. Members should not be accessed directly.
-'int(*subprocess_start_fn)(struct subprocess_entry *entry)'::
- User-supplied function to initialize the sub-process. This is
- typically used to negotiate the interface version and capabilities.
- Function to test two subprocess hashmap entries for equality.
- Start a subprocess and add it to the subprocess hashmap.
- Kill a subprocess and remove it from the subprocess hashmap.
- Find a subprocess in the subprocess hashmap.
- Get the underlying `struct child_process` from a subprocess.
- Helper function to read packets looking for the last "status=<foo>"
- key/value pair.