diff options
author | Christian Grothoff <christian@grothoff.org> | 2017-06-11 02:11:52 +0200 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2017-06-11 02:11:52 +0200 |
commit | 9e1e0255ccf57f2ee0a2be9f4d49ee6308bdd738 (patch) | |
tree | 2f51af2fbd4aec3d1d05003a7fb07d52d2d3e4f8 /src/include | |
parent | c90ae1921559d990c179800ac392b0a5358758fb (diff) | |
download | gnunet-9e1e0255ccf57f2ee0a2be9f4d49ee6308bdd738.tar.gz gnunet-9e1e0255ccf57f2ee0a2be9f4d49ee6308bdd738.zip |
clarify enum values
Diffstat (limited to 'src/include')
-rw-r--r-- | src/include/gnunet_db_lib.h | 9 |
1 files changed, 8 insertions, 1 deletions
diff --git a/src/include/gnunet_db_lib.h b/src/include/gnunet_db_lib.h index 71ac4aae9..9356f66cb 100644 --- a/src/include/gnunet_db_lib.h +++ b/src/include/gnunet_db_lib.h | |||
@@ -25,7 +25,7 @@ | |||
25 | /** | 25 | /** |
26 | * Status code returned from functions running database commands. | 26 | * Status code returned from functions running database commands. |
27 | * Can be combined with a function that returns the number | 27 | * Can be combined with a function that returns the number |
28 | * of results, so non-negative values indicate success. | 28 | * of results, so all non-negative values indicate success. |
29 | */ | 29 | */ |
30 | enum GNUNET_DB_QueryStatus | 30 | enum GNUNET_DB_QueryStatus |
31 | { | 31 | { |
@@ -36,11 +36,15 @@ enum GNUNET_DB_QueryStatus | |||
36 | 36 | ||
37 | /** | 37 | /** |
38 | * A soft error occurred, retrying the transaction may succeed. | 38 | * A soft error occurred, retrying the transaction may succeed. |
39 | * Includes DEADLOCKS and SERIALIZATION errors. | ||
39 | */ | 40 | */ |
40 | GNUNET_DB_STATUS_SOFT_ERROR = -1, | 41 | GNUNET_DB_STATUS_SOFT_ERROR = -1, |
41 | 42 | ||
42 | /** | 43 | /** |
43 | * The transaction succeeded, but yielded zero results. | 44 | * The transaction succeeded, but yielded zero results. |
45 | * May include the case where an INSERT failed with UNIQUE | ||
46 | * violation (i.e. row already exists) or where DELETE | ||
47 | * failed to remove anything (i.e. nothing matched). | ||
44 | */ | 48 | */ |
45 | GNUNET_DB_STATUS_SUCCESS_NO_RESULTS = 0, | 49 | GNUNET_DB_STATUS_SUCCESS_NO_RESULTS = 0, |
46 | 50 | ||
@@ -49,6 +53,9 @@ enum GNUNET_DB_QueryStatus | |||
49 | */ | 53 | */ |
50 | GNUNET_DB_STATUS_SUCCESS_ONE_RESULT = 1 | 54 | GNUNET_DB_STATUS_SUCCESS_ONE_RESULT = 1 |
51 | 55 | ||
56 | /* Larger values may be returned for SELECT statements | ||
57 | that returned more than one result. */ | ||
58 | |||
52 | }; | 59 | }; |
53 | 60 | ||
54 | #endif | 61 | #endif |