diff options
author | David Benjamin <davidben@google.com> | 2016-09-23 21:32:51 +0300 |
---|---|---|
committer | David Benjamin <davidben@google.com> | 2016-09-23 21:39:11 +0300 |
commit | 16279bc559c36797f6178dfb424fdeb7f895a85f (patch) | |
tree | 24b82f07e695756369da6b0536b7092042c34ac7 | |
parent | 5b556200d41bc5b4211dc1137e1bbd9f0652d099 (diff) |
Fix up x509_vpm.c comment.
We used upstream's reformat script, but they had stuck hyphens
everywhere to tell indent to leave a comment alone. Fix this one since
it was especially hard to read.
Change-Id: I9f43bd57dbcf66b79b775ad10ee67867d815ed33
Reviewed-on: https://boringssl-review.googlesource.com/11243
Reviewed-by: Steven Valdez <svaldez@google.com>
Reviewed-by: David Benjamin <davidben@google.com>
-rw-r--r-- | crypto/x509/x509_vpm.c | 47 |
1 files changed, 29 insertions, 18 deletions
diff --git a/crypto/x509/x509_vpm.c b/crypto/x509/x509_vpm.c index b51bc176..9e9dbf5e 100644 --- a/crypto/x509/x509_vpm.c +++ b/crypto/x509/x509_vpm.c @@ -192,25 +192,36 @@ void X509_VERIFY_PARAM_free(X509_VERIFY_PARAM *param) OPENSSL_free(param); } -/* +/*- * This function determines how parameters are "inherited" from one structure - * to another. There are several different ways this can happen. 1. If a - * child structure needs to have its values initialized from a parent they are - * simply copied across. For example SSL_CTX copied to SSL. 2. If the - * structure should take on values only if they are currently unset. For - * example the values in an SSL structure will take appropriate value for SSL - * servers or clients but only if the application has not set new ones. The - * "inh_flags" field determines how this function behaves. Normally any - * values which are set in the default are not copied from the destination and - * verify flags are ORed together. If X509_VP_FLAG_DEFAULT is set then - * anything set in the source is copied to the destination. Effectively the - * values in "to" become default values which will be used only if nothing new - * is set in "from". If X509_VP_FLAG_OVERWRITE is set then all value are - * copied across whether they are set or not. Flags is still Ored though. If - * X509_VP_FLAG_RESET_FLAGS is set then the flags value is copied instead of - * ORed. If X509_VP_FLAG_LOCKED is set then no values are copied. If - * X509_VP_FLAG_ONCE is set then the current inh_flags setting is zeroed after - * the next call. + * to another. There are several different ways this can happen. + * + * 1. If a child structure needs to have its values initialized from a parent + * they are simply copied across. For example SSL_CTX copied to SSL. + * 2. If the structure should take on values only if they are currently unset. + * For example the values in an SSL structure will take appropriate value + * for SSL servers or clients but only if the application has not set new + * ones. + * + * The "inh_flags" field determines how this function behaves. + * + * Normally any values which are set in the default are not copied from the + * destination and verify flags are ORed together. + * + * If X509_VP_FLAG_DEFAULT is set then anything set in the source is copied + * to the destination. Effectively the values in "to" become default values + * which will be used only if nothing new is set in "from". + * + * If X509_VP_FLAG_OVERWRITE is set then all value are copied across whether + * they are set or not. Flags is still Ored though. + * + * If X509_VP_FLAG_RESET_FLAGS is set then the flags value is copied instead + * of ORed. + * + * If X509_VP_FLAG_LOCKED is set then no values are copied. + * + * If X509_VP_FLAG_ONCE is set then the current inh_flags setting is zeroed + * after the next call. */ /* Macro to test if a field should be copied from src to dest */ |