README.md
1gRPC Unix Abstract Socket Example
2================
3
4This example shows how to use gRPC with Unix domain sockets in the abstract namespace.
5gRPC uses the [`unix-abstract:abstract_path`](https://github.com/grpc/grpc/blob/c6844099218b147b0e374843e0a26745adc61ddb/doc/naming.md?plain=1#L44-L50) URI scheme to support this.
6In this example, an socket with an embedded null character `grpc%00abstract` is created.
7
8## Build and run the example
9
10Run `bazel run :server` in one terminal, and `bazel run :client` in another.
11
12The client and server will confirm that a message was sent and received on both ends. The server will continue running until it is shut down.
13While the server is still running, you can confirm that a unix domain socket is in use by running `lsof -U | grep '@grpc@abstract'`.
14