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.