s6
Software
skarnet.org
 The s6-fdholder-delete program 
s6-fdholder-delete connects to a
fd-holding daemon listening on a
Unix domain socket, and deletes a file descriptor from the
daemon storage.
 Interface 
     s6-fdholder-delete [ -t timeout ] path id
 -  s6-fdholder-delete connects to a
s6-fdholderd server process listening on
path. 
-  It tells the server to close the file descriptor that has been
stored with identifier id. 
 Options 
 -  -t timeout : if the operation cannot be
processed in timeout milliseconds, then fail with an error message.
Communications with the server should be near-instant, so this option is
only here to protect users against programming errors (connecting to the
wrong socket, for instance). 
 Exit codes 
 -  0: success. 
-  1: the server denied the operation. The meaning of the error messages
is explained here. 
-  100: wrong usage. 
-  111: system call failed - this includes attempting to connect to a
nonexistent socket, or one where no s6-fdholderd
daemon is listening. 
 Usage example 
   s6-fdholder-delete /service/fdholderd/s MYSOCKET
will tell an s6-fdholderd daemon listening on the
/service/fdholderd/s socket to close the file descriptor 
dentified as MYSOCKET.