subversion-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From br...@apache.org
Subject svn commit: r1848998 - /subversion/trunk/subversion/include/svn_dirent_uri.h
Date Sat, 15 Dec 2018 14:18:00 GMT
Author: brane
Date: Sat Dec 15 14:18:00 2018
New Revision: 1848998

URL: http://svn.apache.org/viewvc?rev=1848998&view=rev
Log:
* subversion/include/svn_dirent_uri.h
  (svn_dirent_canonicalize,
   svn_relpath_canonicalize,
   svn_uri_canonicalize): Update docstrings, refering to the safe versions.

Modified:
    subversion/trunk/subversion/include/svn_dirent_uri.h

Modified: subversion/trunk/subversion/include/svn_dirent_uri.h
URL: http://svn.apache.org/viewvc/subversion/trunk/subversion/include/svn_dirent_uri.h?rev=1848998&r1=1848997&r2=1848998&view=diff
==============================================================================
--- subversion/trunk/subversion/include/svn_dirent_uri.h (original)
+++ subversion/trunk/subversion/include/svn_dirent_uri.h Sat Dec 15 14:18:00 2018
@@ -486,7 +486,8 @@ svn_boolean_t
 svn_uri_is_root(const char *uri,
                 apr_size_t len);
 
-/** Return a new dirent like @a dirent, but transformed such that some types
+/**
+ * Return a new dirent like @a dirent, but transformed such that some types
  * of dirent specification redundancies are removed.
  *
  * This involves:
@@ -500,6 +501,10 @@ svn_uri_is_root(const char *uri,
  *
  * Allocate the result in @a result_pool.
  *
+ * @warning This function may call @c abort() if @a dirent can not be
+ *          canonicalized.
+ *          Use svn_dirent_canonicalize_safe() for tainted input.
+ *
  * @since New in 1.6.
  */
 const char *
@@ -531,7 +536,8 @@ svn_dirent_canonicalize_safe(const char
                              apr_pool_t *scratch_pool);
 
 
-/** Return a new relpath like @a relpath, but transformed such that some types
+/**
+ * Return a new relpath like @a relpath, but transformed such that some types
  * of relpath specification redundancies are removed.
  *
  * This involves:
@@ -543,6 +549,10 @@ svn_dirent_canonicalize_safe(const char
  *
  * Allocate the result in @a result_pool.
  *
+ * @warning This function may call @c abort() if @a relpath can not be
+ *          canonicalized.
+ *          Use svn_relpath_canonicalize_safe() for tainted input.
+ *
  * @since New in 1.7.
  */
 const char *
@@ -575,7 +585,8 @@ svn_relpath_canonicalize_safe(const char
                               apr_pool_t *scratch_pool);
 
 
-/** Return a new uri like @a uri, but transformed such that some types
+/**
+ * Return a new uri like @a uri, but transformed such that some types
  * of uri specification redundancies are removed.
  *
  * This involves:
@@ -592,7 +603,11 @@ svn_relpath_canonicalize_safe(const char
  *
  * Allocate the result in @a result_pool.
  *
- * @since New in 1.7.
+ * @warning This function may call @c abort() if @a uri can not be
+ *          canonicalized.
+ *          Use svn_uri_canonicalize_safe() for tainted input.
+ *
+  * @since New in 1.7.
  */
 const char *
 svn_uri_canonicalize(const char *uri,



Mime
View raw message