From 043a15afa7a38113e7a2b0b7931d0c5150882526 Mon Sep 17 00:00:00 2001 From: Tilghman Lesher Date: Fri, 13 Jun 2008 22:52:20 +0000 Subject: [PATCH] Document the input for ast_realtime_require_field() git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@122766 65c4cc65-6c06-0410-ace0-fbb531ad65f3 --- include/asterisk/config.h | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/include/asterisk/config.h b/include/asterisk/config.h index fdcd28a40b..b6c5dbd148 100644 --- a/include/asterisk/config.h +++ b/include/asterisk/config.h @@ -227,8 +227,22 @@ int ast_unload_realtime(const char *family); * exist in the backend. The backends may take various actions, such as * creating new fields in the data store or warning the administrator that * new fields may need to be created, in order to ensure proper function. + * + * The arguments are specified in groups of 3: column name, column type, + * and column size. The column types are specified as integer constants, + * defined by the enum require_type. Note that the size is specified as + * the number of equivalent character fields that a field may take up, even + * if a field is otherwise specified as an integer type. This is due to + * the fact that some fields have historically been specified as character + * types, even if they contained integer values. + * + * A family should always specify its fields to the minimum necessary + * requirements to fulfill all possible values (within reason; for example, + * a timeout value may reasonably be specified as an INTEGER2, with size 5. + * Even though values above 32767 seconds are possible, they are unlikely + * to be useful, and we should not complain about that size). */ -int ast_require_realtime_fields(const char *family, ...) attribute_sentinel; +int ast_realtime_require_field(const char *family, ...) attribute_sentinel; /*! * \brief Retrieve realtime configuration @@ -277,8 +291,6 @@ int ast_destroy_realtime(const char *family, const char *keyfield, const char *l */ int ast_check_realtime(const char *family); -int ast_realtime_require_field(const char *family, ...) attribute_sentinel; - /*! \brief Check if there's any realtime engines loaded */ int ast_realtime_enabled(void);