- updated documentation

src/iec61850/client/ied_connection.c

@@ -2530,7 +2530,7 @@ FileDirectoryEntry_destroy(FileDirectoryEntry self)
     GLOBAL_FREEMEM(self);
 }
 
-char*
+const char*
 FileDirectoryEntry_getFileName(FileDirectoryEntry self)
 {
     return self->fileName;

src/iec61850/inc/iec61850_client.h

@@ -1,7 +1,7 @@
 /*
  *  iec61850_client.h
  *
- *  Copyright 2013, 2014, 2015 Michael Zillgith
+ *  Copyright 2013-2018 Michael Zillgith
  *
  *  This file is part of libIEC61850.
  *
@@ -1949,18 +1949,49 @@ IedConnection_queryLogAfter(IedConnection self, IedClientError* error, const cha
 
 typedef struct sFileDirectoryEntry* FileDirectoryEntry;
 
+/**
+ * @deprecated Will be removed from API
+ */
 FileDirectoryEntry
 FileDirectoryEntry_create(const char* fileName, uint32_t fileSize, uint64_t lastModified);
 
+/**
+ * \brief Destroy a FileDirectoryEntry object (free all resources)
+ *
+ * NOTE: Usually is called as a parameter of the \ref LinkedList_destroyDeep function.
+ *
+ * \param self the FileDirectoryEntry object
+ */
 void
 FileDirectoryEntry_destroy(FileDirectoryEntry self);
 
-char*
+/**
+ * \brief Get the name of the file
+ *
+ * \param self the FileDirectoryEntry object
+ *
+ * \return name of the file as null terminated string
+ */
+const char*
 FileDirectoryEntry_getFileName(FileDirectoryEntry self);
 
+/**
+ * \brief Get the file size in bytes
+ *
+ * \param self the FileDirectoryEntry object
+ *
+ * \return size of the file in bytes, or 0 if file size is unknown
+ */
 uint32_t
 FileDirectoryEntry_getFileSize(FileDirectoryEntry self);
 
+/**
+ * \brief Get the timestamp of last modification of the file
+ *
+ * \param self the FileDirectoryEntry object
+ *
+ * \return UTC timestamp in milliseconds
+ */
 uint64_t
 FileDirectoryEntry_getLastModified(FileDirectoryEntry self);
 

src/tls/mbedtls/tls_mbedtls.c

@@ -51,6 +51,9 @@ struct sTLSConfiguration {
 
     bool chainValidation;
     bool allowOnlyKnownCertificates;
+
+    /* TLS session renegotioation time in milliseconds */
+    int renegotiationTimeInMs;
 };
 
 struct sTLSSocket {
@@ -305,6 +308,12 @@ TLSConfiguration_addCACertificateFromFile(TLSConfiguration self, const char* fil
     return (ret == 0);
 }
 
+void
+TLSConfiguration_setRenegotiationTime(TLSConfiguration self, int timeInMs)
+{
+    self->renegotiationTimeInMs = timeInMs;
+}
+
 void
 TLSConfiguration_destroy(TLSConfiguration self)
 {
@@ -402,8 +411,6 @@ TLSSocket_getPeerCertificate(TLSSocket self, int* certSize)
 bool
 TLSSocket_performHandshake(TLSSocket self)
 {
-    //TODO evaluate return value
-
     if (mbedtls_ssl_renegotiate(&(self->ssl)) == 0)
         return true;
     else