• Stars
    star
    164
  • Rank 230,032 (Top 5 %)
  • Language
    C
  • License
    Other
  • Created almost 11 years ago
  • Updated about 7 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A tiny library to send file descriptors across processes

flingfd

flingfd is a small, standalone C library to pass file descriptors across processes on Linux.

Installation

By default, flingfd installs in /usr/local. If you want to change where it gets installed, edit the PREFIX in the Makefile.

  $ make && sudo make install

Documentation

The library consists of two functions declared in flingfd.h:

  bool flingfd_simple_send(const char *path, int fd);
  int flingfd_simple_recv(const char *path);

When you want to send a file descriptor, call flingfd_simple_send and receive it in the other process with flingfd_simple_recv. Make sure you use the same path argument in both processes -- that determines which process gets the file descriptor.

Here's an example of sending stdout to another process:

  #include <flingfd.h>

  void send_my_stdout() {
    int fd = fileno(stdout);
    flingfd_simple_send("/tmp/some_unique_path", fd);
  }

And here's the other process writing to the sender's stdout:

  #include <flingfd.h>

  void write_to_their_stdout() {
    int fd = flingfd_simple_recv("/tmp/some_unique_path");
    write(fd, "Hello world\n", 12);
  }

When you're done writing your code, link against the library with -lflingfd.

Bindings

License

Apache 2.0