rollingpolicy.h File Reference
Log4c rolling policy interface. Defines the interface for managing and providing rolling policies.
More...
#include <stdio.h>
#include <log4c/defs.h>
#include <log4c/layout.h>
Go to the source code of this file.
Detailed Description
Log4c rolling policy interface. Defines the interface for managing and providing rolling policies.
A rolling policy is used to confogure a rollingfile appender to tell it when to trigger a rolover event.
Define Documentation
#define ROLLINGPOLICY_ROLLOVER_ERR_CAN_LOG 0x05 |
Effect a rollover according to policyp on the given file stream.
- Parameters:
-
| policyp | pointer to the rolling policy |
| fp | filestream to rollover. |
- Returns:
- zero if successful, non-zero otherwise. The policy can return an indication that something went wrong but that the rollingfile appender can stull go ahead and log by returning an error code <= ROLLINGPOLICY_ROLLOVER_ERR_CAN_LOG. Anything greater than means that the rolling file appender will not try to log it's message.
Typedef Documentation
Function Documentation
Call the un initialization code of a rolling policy. This will call the fini routine of the particular rollingpolicy type to allow it to free up resources. If the call to fini in the rollingpolicy type fails then the rollingpolicy is not uninitialized. Try again later model...
- Parameters:
-
| policyp | pointer to the rolling policy |
- Returns:
- zero if successful, non-zero otherwise.
Get a new rolling policy
- Parameters:
-
| policy_name | a name for the policy |
- Returns:
- a new rolling policy, otherwise NULL.
Get the rollingfile appender associated with this policy.
- Parameters:
-
| policyp | pointer to the rolling policy |
- Returns:
- pointer to the rolling file appender associated with this policy
Get the rolling policy configuration.
- Parameters:
-
| policyp | pointer to the rolling policy |
- Returns:
- pointer to the rolling policy configuration.
Call the initialization code of a rolling policy.
- Parameters:
-
| policyp | pointer to the rolling policy |
| app | the rolling appender this policy is used with |
- Returns:
- zero if successful, non-zero otherwise.
Determine if a logging event should trigger a rollover according to the given policy.
- Parameters:
-
| policyp | pointer to the rolling policy |
| evtp | the logging event pointer. |
| current_file_size | the size of the current file being logged to. |
- Returns:
- non-zero if rollover required, zero otherwise.
sets the rolling policy type
- Parameters:
-
| a_rollingpolicy | the log4c_rollingpolicy_t object |
| a_type | the new rollingpolicy type |
- Returns:
- the previous appender type
Configure a rolling policy with a specific policy.
- Parameters:
-
| policyp | pointer to the rolling policy |
| udatap | a specific policy type, for example sizewin. |
- Returns:
- zero if successful, non-zero otherwise.
Get a pointer to an existing rollingpolicy type.
- Parameters:
-
| a_name | the name of the rollingpolicy type to return. |
- Returns:
- a pointer to an existing rollingpolicy type, or NULL if no rollingpolicy type with the specified name exists.
Use this function to register a rollingpolicy type with log4c. Once this is done you may refer to this type by name both programmatically and in the log4c configuration file.
- Parameters:
-
| a_type | a pointer to the new rollingpolicy type to register. |
- Returns:
- a pointer to the previous rollingpolicy type of same name.
Example code fragment:
const log4c_rollingpolicy_type_t log4c_rollingpolicy_type_sizewin = {
"sizewin",
sizewin_init,
sizewin_is_triggering_event,
sizewin_rollover
};
log4c_rollingpolicy_type_set(&log4c_rollingpolicy_type_sizewin);
References log4c_rollingpolicy_type::name.