added mapi_set_authdata description

git-svn-id: file:///home/svn/mapi/trunk@228 8d5bb341-7cf1-0310-8cf6-ba355fef3186

mapi.3

@@ -26,7 +26,7 @@ MAPI \- Monitoring Application Programming Interface
 .br
 .BI "void * mapi_read_results(int " fd ", int " fid ", int " copy ");"
 .br
-.BI "int mapi_set_authdata(int " fd ", const char *" pub ", const char *" priv ", const char *" creds ");"
+.BI "int mapi_set_authdata(int " fd ", const char *" public_key ", const char *" private_key ", const char *" credentials ");"
 .br
 .BI "int mapi_load_library(char *" library ");"
 .br
@@ -192,9 +192,18 @@ with the description of the error denoted by
 .IR err_no .
 Memory for both arguments must have been previously allocated.
 .sp
-.BI "int mapi_set_authdata(int " fd ", char *" pub ", char *" priv ", char *" creds ");"
-.br
-Sets the required information to authorize a flow.
+.BI "int mapi_set_authdata(int " fd ", char *" public_key ", char *" private_key ", char *" credentials ");"
+.br
+.B mapi_set_authdata() 
+sets the required information to authorize a flow. 
+This function is required only if authorization is 
+enabled in the mapi sensor. Keys are 
+used to authenticate the user while the credentials provide
+the sensor with the policy that the flow should comform with.
+The user can retreive the digitaly signed credentials (so that 
+thay can not be altered) from the administrator of each 
+sensor. Authorization is performed upon 
+.B mapi_connect().
 .br
 .sp
 .BI "int mapi_load_library(char *" lib ");"