summaryrefslogtreecommitdiffstats
path: root/doc/introduction.dox
diff options
context:
space:
mode:
authorEric Bischoff <eric@bureau-cornavin.com>2010-08-23 21:00:35 +0200
committerAris Adamantiadis <aris@0xbadc0de.be>2010-08-23 21:00:35 +0200
commit94b689e19d51ab887afe95afd8e9bf50a18af0c4 (patch)
tree4006c0cdfe0be48e3af0d104221db08d12dda046 /doc/introduction.dox
parent8066100f5360e33f6c02d00ee727a434d8af014e (diff)
downloadlibssh-94b689e19d51ab887afe95afd8e9bf50a18af0c4.tar.gz
libssh-94b689e19d51ab887afe95afd8e9bf50a18af0c4.tar.xz
libssh-94b689e19d51ab887afe95afd8e9bf50a18af0c4.zip
New update of doxygen documentation
Diffstat (limited to 'doc/introduction.dox')
-rw-r--r--doc/introduction.dox39
1 files changed, 39 insertions, 0 deletions
diff --git a/doc/introduction.dox b/doc/introduction.dox
new file mode 100644
index 0000000..fde9fd3
--- /dev/null
+++ b/doc/introduction.dox
@@ -0,0 +1,39 @@
+@page tutorial The Tutorial
+@section introduction Introduction
+
+libssh is a C library that enables you to write a program that uses the
+SSH protocol. With it, you can remotely execute programs, transfer
+files, or use a secure and transparent tunnel for your remote programs.
+The SSH protocol is encrypted, ensures data integrity, and provides strong
+means of authenticating both the server of the client. The library hides
+a lot of technical details from the SSH protocol, but this does not
+mean that you should not try to know about and understand these details.
+
+libssh is a Free Software / Open Source project. The libssh library
+is distributed under LGPL license. The libssh project has nothing to do with
+"libssh2", which is a completly different and independant project.
+
+This tutorial concentrates for its main part on the "client" side of libssh.
+To learn how to accept incoming SSH connexions (how to write a SSH server),
+you'll have to jump to the end of this document.
+
+This tutorial describes libssh version 0.5.0. This version is the development
+version and is *not* published yet. However, the examples should work with
+little changes on versions like 0.4.2 and later.
+
+
+Table of contents:
+
+@subpage guided_tour
+
+@subpage authentication
+
+@subpage shell
+
+@subpage commands
+
+@subpage sftp
+
+@subpage tbd
+
+