summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/man/Makefile.am1
-rw-r--r--doc/man/gnunet-core.135
-rw-r--r--src/core/Makefile.am12
-rw-r--r--src/core/gnunet-core.c (renamed from src/core/gnunet-core-list-connections.c)0
-rw-r--r--src/include/gnunet_fs_service.h6
5 files changed, 46 insertions, 8 deletions
diff --git a/doc/man/Makefile.am b/doc/man/Makefile.am
index 629ab6d13..c640460c4 100644
--- a/doc/man/Makefile.am
+++ b/doc/man/Makefile.am
@@ -1,5 +1,6 @@
man_MANS = \
gnunet-arm.1 \
+ gnunet-core.1 \
gnunet-directory.1 \
gnunet-download.1 \
gnunet-download-manager.1 \
diff --git a/doc/man/gnunet-core.1 b/doc/man/gnunet-core.1
new file mode 100644
index 000000000..0971b423c
--- /dev/null
+++ b/doc/man/gnunet-core.1
@@ -0,0 +1,35 @@
+.TH gnunet\-core "1" "1 Apr 2012" "GNUnet"
+.SH NAME
+gnunet\-core \- measure and control the core subsystem
+
+.SH SYNOPSIS
+.B gnunet\-core
+[\fIOPTIONS\fR]
+.SH DESCRIPTION
+.PP
+
+gnunet\-core is a tool to access various functions of GNUnet's core subsystem from the command\-line. The only function right now is to list the peers that are directly connected to this peer (with successful cryptographic handshake).
+
+.TP
+\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR
+configuration file to use
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+print help page
+.TP
+\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=LOGLEVEL\fR
+Change the loglevel. Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
+.TP
+\fB\-v\fR, \fB\-\-version\fR
+print the version number
+.TP
+\fB\-V\fR, \fB\-\-verbose\fR
+be verbose
+
+.SH NOTES
+
+
+.SH "REPORTING BUGS"
+Report bugs by using mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
+.SH "SEE ALSO"
+\fBgnunet\-transport\fP(1)
diff --git a/src/core/Makefile.am b/src/core/Makefile.am
index ad9bddcb6..b79b6cc6a 100644
--- a/src/core/Makefile.am
+++ b/src/core/Makefile.am
@@ -31,7 +31,7 @@ libgnunetcore_la_LDFLAGS = \
bin_PROGRAMS = \
gnunet-service-core \
- gnunet-core-list-connections
+ gnunet-core
gnunet_service_core_SOURCES = \
gnunet-service-core.c gnunet-service-core.h \
@@ -49,14 +49,12 @@ gnunet_service_core_LDADD = \
$(GN_LIBINTL) -lz
-gnunet_core_list_connections_SOURCES = \
- gnunet-core-list-connections.c
-gnunet_core_list_connections_LDADD = \
+gnunet_core_SOURCES = \
+ gnunet-core.c
+gnunet_core_LDADD = \
$(top_builddir)/src/core/libgnunetcore.la \
- $(top_builddir)/src/transport/libgnunettransport.la \
- $(top_builddir)/src/hello/libgnunethello.la \
$(top_builddir)/src/util/libgnunetutil.la
-gnunet_core_list_connections_DEPENDENCIES = \
+gnunet_core_DEPENDENCIES = \
libgnunetcore.la
check_PROGRAMS = \
diff --git a/src/core/gnunet-core-list-connections.c b/src/core/gnunet-core.c
index 4fe0a4f86..4fe0a4f86 100644
--- a/src/core/gnunet-core-list-connections.c
+++ b/src/core/gnunet-core.c
diff --git a/src/include/gnunet_fs_service.h b/src/include/gnunet_fs_service.h
index 3eb58921a..1f1e60f0f 100644
--- a/src/include/gnunet_fs_service.h
+++ b/src/include/gnunet_fs_service.h
@@ -1820,7 +1820,11 @@ GNUNET_FS_file_information_create_from_data (struct GNUNET_FS_Handle *h,
* @param cls closure
* @param offset offset to read from; it is possible
* that the caller might need to go backwards
- * a bit at times
+ * a bit at times; set to UINT64_MAX to tell
+ * the reader that we won't be reading for a while
+ * (used to close the file descriptor but NOT fully
+ * clean up the reader's state); in this case,
+ * a value of '0' for max should be ignored
* @param max maximum number of bytes that should be
* copied to buf; readers are not allowed
* to provide less data unless there is an error;