From 0c951b9f27ac5b4d25b6da486aa241611005c330 Mon Sep 17 00:00:00 2001
From: Andreas Schneider <asn@cryptomilk.org>
Date: Thu, 1 Aug 2019 17:11:34 +0200
Subject: [PATCH] channel: Document ssh_channel_request_sftp()

Signed-off-by: Andreas Schneider <asn@cryptomilk.org>
Reviewed-by: Jakub Jelen <jjelen@redhat.com>
(cherry picked from commit e5767bf0b778be4e0948de0b8e32b86a3c85460a)
---
 src/channels.c | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/src/channels.c b/src/channels.c
index 23666137..412dd9ce 100644
--- a/src/channels.c
+++ b/src/channels.c
@@ -1964,6 +1964,18 @@ error:
   return rc;
 }
 
+/**
+ * @brief Request sftp subsystem on the channel
+ *
+ * @param[in]  channel The channel to request the sftp subsystem.
+ *
+ * @return              SSH_OK on success,
+ *                      SSH_ERROR if an error occurred,
+ *                      SSH_AGAIN if in nonblocking mode and call has
+ *                      to be done again.
+ *
+ * @note You should use sftp_new() which does this for you.
+ */
 int ssh_channel_request_sftp( ssh_channel channel){
     if(channel == NULL) {
         return SSH_ERROR;