.\" -*- mode: troff; coding: utf-8 -*-
.TH "nix3-store-ping" "1" ""
.PP
\fBWarning\fR: This program is \fBexperimental\fR and its interface is subject to change.
.SH Name
\fCnix store ping\fR - test whether a store can be accessed
.SH Synopsis
\fCnix store ping\fR [\fIoption\fR\[u2026]] 
.SH Examples
.IP "\(bu" 2
Test whether connecting to a remote Nix store via SSH works:
.LP
.EX
# nix store ping --store ssh://mac1
.EE
.IP "\(bu" 2
Test whether a URL is a valid binary cache:
.LP
.EX
# nix store ping --store https://cache.nixos.org
.EE
.IP "\(bu" 2
Test whether the Nix daemon is up and running:
.LP
.EX
# nix store ping --store daemon
.EE
.SH Description
This command tests whether a particular Nix store (specified by the
argument \fC--store\fR \fIurl\fR) can be accessed. What this means is
dependent on the type of the store. For instance, for an SSH store it
means that Nix can connect to the specified machine.
.PP
If the command succeeds, Nix returns a exit code of 0 and does not
print any output.