.\" This file is part of GNUnet.
.\" Copyright (C) 2023 GNUnet e.V.
.\"
.\" Permission is granted to copy, distribute and/or modify this document
.\" under the terms of the GNU Free Documentation License, Version 1.3 or
.\" any later version published by the Free Software Foundation; with no
.\" Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.  A
.\" copy of the license is included in the file
.\" FDL-1.3.
.\"
.\" A copy of the license is also available from the Free Software
.\" Foundation Web site at http://www.gnu.org/licenses/fdl.html}.
.\"
.\" Alternately, this document is also available under the General
.\" Public License, version 3 or later, as published by the Free Software
.\" Foundation.  A copy of the license is included in the file
.\" GPL3.
.\"
.\" A copy of the license is also available from the Free Software
.\" Foundation Web site at http://www.gnu.org/licenses/gpl.html
.\"
.\" SPDX-License-Identifier: GPL3.0-or-later OR FDL1.3-or-later
.\"
.Dd January 5, 2023
.Dt GNUNET-DHT-PUT 1
.Os
.Sh NAME
.Nm gnunet-dht-put
.Nd Issue a PUT request to the DHT to insert
.Ar DATA
under
.Ar KEY .
.Sh SYNOPSIS
.Nm
.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
.Op Fl d Ar DATA | Fl -data= Ns Ar DATA
.Op Fl e Ar EXPIRATION | Fl -expiration= Ns Ar EXPIRATION
.Op Fl h | -help
.Op Fl k Ar KEY | Fl -key= Ns Ar KEY
.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
.Op Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
.Op Fl R | -record
.Op Fl r Ar LEVEL | Fl -replication= Ns Ar LEVEL
.Op Fl t Ar TYPE | Fl -type= Ns Ar TYPE
.Op Fl V | -verbose
.Op Fl v | -version
.Op Fl x | -demultiplex
.Sh DESCRIPTION
.Nm
is a command line tool to issue PUT requests to the DHT.
.Sh OPTIONS
.Bl -tag -width indent
.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
Use the configuration file
.Ar FILENAME .
.It Fl d Ar DATA | Fl -data= Ns Ar DATA
the data to insert under
.Ar KEY .
.It Fl e Ar EXPIRATION | Fl -expiration= Ns Ar EXPIRATION
how long to store this entry in the DHT (in seconds)
.It Fl h | -help
Print short help on options.
.It Fl k Ar KEY | Fl -key= Ns Ar KEY
use the query key
.Ar KEY .
.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
Use LOGLEVEL for logging.
Valid values are DEBUG, INFO, WARNING and ERROR.
.It Fl l Ar LOGFILE | Fl -logfile= Ns Ar LOGFILE
Configure logging to write logs to
.Ar LOGFILE .
.It Fl R | -record
Set DHT's record route option for the request.
.It Fl r Ar LEVEL | -replication-level= Ns Ar LEVEL
Use the DHT replication level
.Ar LEVEL .
.It Fl t Ar TYPE | -type= Ns Ar TYPE
the block type of
.Ar DATA .
.It Fl V | -verbose
be verbose.
.It Fl v | -version
Print GNUnet version number.
.It Fl x | -demultiplex
Set DHT's demultiplex everywhere option.
.El
.Sh SEE ALSO
The full documentation for gnunet is maintained as a Texinfo manual.
If the
.Xr info 1
and gnunet programs are properly installed at your site, the command
.Pp
.Dl info gnunet
.\".Sh HISTORY
.\".Sh AUTHORS
.Sh BUGS
Report bugs by using
.Lk https://bugs.gnunet.org
or by sending electronic mail to
.Aq Mt gnunet-developers@gnu.org .