README.md
1 # gRPC in 3 minutes (C++)
2
3 ## Installation
4
5 To install gRPC on your system, follow the instructions to build from source
6 [here](../../BUILDING.md). This also installs the protocol buffer compiler
7 `protoc` (if you don't have it already), and the C++ gRPC plugin for `protoc`.
8
9 ## Hello C++ gRPC!
10
11 Here's how to build and run the C++ implementation of the [Hello
12 World](../protos/helloworld.proto) example used in [Getting started](..).
13
14 ### Client and server implementations
15
16 The client implementation is at [greeter_client.cc](helloworld/greeter_client.cc).
17
18 The server implementation is at [greeter_server.cc](helloworld/greeter_server.cc).
19
20 ### Try it!
21 Build client and server:
22
23 ```sh
24 $ make
25 ```
26
27 Run the server, which will listen on port 50051:
28
29 ```sh
30 $ ./greeter_server
31 ```
32
33 Run the client (in a different terminal):
34
35 ```sh
36 $ ./greeter_client
37 ```
38
39 If things go smoothly, you will see the "Greeter received: Hello world" in the
40 client side output.
41
42 ## Tutorial
43
44 You can find a more detailed tutorial in [gRPC Basics: C++](cpptutorial.md)
45