RD_AddLog
7
January 2017
Rivendell C Library Manual

# rd_addlog

Rivendell Add Log C Library Function
Todd
Baker
bakert@rfa.org
Rivendell C Library Author

        #include <rivwebcapi/rd_addlog.h>

        int RD_AddLog
          const char hostname[]
          const char username[]
          const char passwd[]
          const char ticket[]
          const char log_name[]
          const char svc_name[]
          const char user_agent[]

## Description

`RD_AddLog` is the function to use to add a log to an existing Rivendell Database.

This function adds the specified log to the Rivendell database on hostname. Default values are used when the log is created.

### RD_AddLog function call fields

FIELD NAME | FIELD TYPE | MEANING | REMARKS
--- | --- | --- | ---
hostname | Character Array | Name Of Rivendell DB Host | Mandatory
username | Character Array | Rivendell User Name | Mandatory When NO Ticket Provided
passwd | Character Array | Rivendell User Password | Mandatory When NO Ticket Provided
ticket | Character Array | Rivendell Authentification Ticket | Mandatory When NO User/Password Pair Provided.
log_name | Character Array | Name to assign to new log | Mandatory
svc_name | Character Array | Name of the Rivendell Service to own the new log | Mandatory
user_agent | Character Array | User Agent Value put into HTTP request | Optional (default is Rivendell-C-API/x.x.x)

## RETURN VALUE

On success, zero is returned.

If a server error occurs a -1 is returned. If a client error occurs a specific error number is returned.

## ERRORS

400 Invalid/Missing Parameter for LOG_NAME or SVC_NAME.

403 User Authentification Error.

404 User Permission Error or Invalid Service.

500 Unable to Create Log.

nnn Unknown Error Occurred.