Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

tutorials/05_services: Windows improvements #536

Merged
merged 1 commit into from
Sep 16, 2024
Merged

tutorials/05_services: Windows improvements #536

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 23 additions & 8 deletions tutorials/05_services.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -609,6 +609,25 @@ cmake --build . --config Release

## Running the examples

> **NOTE**
> It is essential to have a valid value of `GZ_PARTITION` environment variable
> and to have it set to the same value in all open terminals. As `GZ_PARTITION`
> is based on hostname and username, especially Windows and Mac users might
> have problems due to spaces in their username, which are not a valid character
> in `GZ_PARTITION`. gz-transport prints error `Invalid partition name` in such
> case. To resolve that, set `GZ_PARTITION` explicitly to a valid value:
> ```bash
> # Linux and Mac
> export GZ_PARTITION=test
> # Windows
> set GZ_PARTITION=test
> ```

> **NOTE**
> On Windows, you can see firewall or antivirus prompts when running the examples.
> For them to work properly, you should allow all communication to the
> example programs.

Open three new terminals and from your ``build/`` directory run the executables.

From terminal 1:
Expand Down Expand Up @@ -661,7 +680,11 @@ directory run the executables.
From terminal 1:

```{.sh}
# Linux and MacOS
./responser_oneway

# Windows
.\Release\responser_oneway.exe
```

From terminal 2:
Expand All @@ -678,11 +701,7 @@ In your responser terminal, you should expect an output similar to this one,
showing that your service provider has received a request:

```{.sh}
# Linux and MacOS
./responser_oneway

# Windows
.\Release\responser_oneway.exe
Request received: [HELLO]
```

Expand Down Expand Up @@ -723,12 +742,8 @@ In your requesters' terminals, you should expect an output similar to this one,
showing that you have received a response:

```{.sh}
# Linux and MacOS
./requester_no_input

# Windows
.\Release\requester_no_input.exe

Press <CTRL-C> to exit
Response: [This is it! This is the answer. It says here...that a bolt of
lightning is going to strike the clock tower at precisely 10:04pm, next
Expand Down
Loading