xref: /aosp_15_r20/external/grpc-grpc/examples/cpp/unix_abstract_sockets/README.md (revision cc02d7e222339f7a4f6ba5f422e6413f4bd931f2)
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