From 23b4a410c6b5d981fc51bc6c3d274a632471ef5e Mon Sep 17 00:00:00 2001
From: Frederic Peters <fpeters@entrouvert.com>
Date: Wed, 22 Dec 2004 11:44:13 +0000
Subject: documented #LassoServer

---
 docs/reference/lasso-sections.txt | 367 +++-----------------------------------
 docs/reference/lasso.sgml         |  41 +++--
 docs/reference/tmpl/provider.sgml |  50 +++---
 docs/reference/tmpl/server.sgml   | 120 +++++++++++++
 4 files changed, 195 insertions(+), 383 deletions(-)
 create mode 100644 docs/reference/tmpl/server.sgml

(limited to 'docs/reference')

diff --git a/docs/reference/lasso-sections.txt b/docs/reference/lasso-sections.txt
index 1e0c8bd7..0d526f75 100644
--- a/docs/reference/lasso-sections.txt
+++ b/docs/reference/lasso-sections.txt
@@ -8,15 +8,15 @@ LassoProviderRole
 lassoHttpMethod
 lassoMdProtocolType
 lasso_provider_new
-lasso_provider_get_metadata_one
-lasso_provider_get_metadata_list
-lasso_provider_load_metadata
 lasso_provider_new_from_dump
-lasso_provider_verify_signature
-lasso_provider_get_first_http_method
 lasso_provider_accept_http_method
-lasso_provider_has_protocol_profile
 lasso_provider_get_base64_succint_id
+lasso_provider_get_first_http_method
+lasso_provider_get_metadata_list
+lasso_provider_get_metadata_one
+lasso_provider_has_protocol_profile
+lasso_provider_load_metadata
+lasso_provider_verify_signature
 <SUBSECTION Standard>
 LASSO_PROVIDER
 LASSO_IS_PROVIDER
@@ -27,7 +27,28 @@ LASSO_IS_PROVIDER_CLASS
 LASSO_PROVIDER_GET_CLASS
 </SECTION>
 
-
+<SECTION>
+<FILE>server</FILE>
+<TITLE>LassoServer</TITLE>
+LassoServer
+lasso_server_new
+lasso_server_new_from_dump
+lasso_server_add_provider
+lasso_server_add_service
+lasso_server_destroy
+lasso_server_dump
+lasso_server_get_first_providerID
+lasso_server_get_provider
+lasso_server_get_providerID_from_hash
+<SUBSECTION Standard>
+LASSO_SERVER
+LASSO_IS_SERVER
+LASSO_TYPE_SERVER
+lasso_server_get_type
+LASSO_SERVER_CLASS
+LASSO_IS_SERVER_CLASS
+LASSO_SERVER_GET_CLASS
+</SECTION>
 
 <SECTION>
 <FILE>lib_assertion</FILE>
@@ -913,11 +934,6 @@ LASSO_IS_SOAP_ENV_ENVELOPE_CLASS
 LASSO_SOAP_ENV_ENVELOPE_GET_CLASS
 </SECTION>
 
-<SECTION>
-<FILE>export</FILE>
-extern
-</SECTION>
-
 <SECTION>
 <FILE>lasso</FILE>
 lasso_init
@@ -937,140 +953,6 @@ LASSO_VERSION_SUBMINOR
 LASSO_VERSION_INFO
 </SECTION>
 
-<SECTION>
-<FILE>protocols</FILE>
-</SECTION>
-
-<SECTION>
-<FILE>artifact</FILE>
-<TITLE>LassoArtifact</TITLE>
-LassoArtifact
-LassoArtifactClass
-lasso_artifact_new
-lasso_artifact_new_from_query
-lasso_artifact_new_from_lares
-lasso_artifact_get_assertionHandle
-lasso_artifact_get_byteCode
-lasso_artifact_get_b64IdentityProviderSuccinctID
-lasso_artifact_get_relayState
-lasso_artifact_get_samlArt
-<SUBSECTION Standard>
-LASSO_ARTIFACT
-LASSO_IS_ARTIFACT
-LASSO_TYPE_ARTIFACT
-lasso_artifact_get_type
-LASSO_ARTIFACT_CLASS
-LASSO_IS_ARTIFACT_CLASS
-LASSO_ARTIFACT_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>assertion</FILE>
-<TITLE>LassoAssertion</TITLE>
-LassoAssertion
-LassoAssertionClass
-lasso_assertion_new
-<SUBSECTION Standard>
-LASSO_ASSERTION
-LASSO_IS_ASSERTION
-LASSO_TYPE_ASSERTION
-lasso_assertion_get_type
-LASSO_ASSERTION_CLASS
-LASSO_IS_ASSERTION_CLASS
-LASSO_ASSERTION_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>authentication_statement</FILE>
-<TITLE>LassoAuthenticationStatement</TITLE>
-LassoAuthenticationStatement
-LassoAuthenticationStatementClass
-lasso_authentication_statement_new
-<SUBSECTION Standard>
-LASSO_AUTHENTICATION_STATEMENT
-LASSO_IS_AUTHENTICATION_STATEMENT
-LASSO_TYPE_AUTHENTICATION_STATEMENT
-lasso_authentication_statement_get_type
-LASSO_AUTHENTICATION_STATEMENT_CLASS
-LASSO_IS_AUTHENTICATION_STATEMENT_CLASS
-LASSO_AUTHENTICATION_STATEMENT_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>authn_request</FILE>
-<TITLE>LassoAuthnRequest</TITLE>
-LassoAuthnRequest
-LassoAuthnRequestClass
-lasso_authn_request_get_protocolProfile
-lasso_authn_request_new
-lasso_authn_request_new_from_export
-lasso_authn_request_set_requestAuthnContext
-lasso_authn_request_set_scoping
-<SUBSECTION Standard>
-LASSO_AUTHN_REQUEST
-LASSO_IS_AUTHN_REQUEST
-LASSO_TYPE_AUTHN_REQUEST
-lasso_authn_request_get_type
-LASSO_AUTHN_REQUEST_CLASS
-LASSO_IS_AUTHN_REQUEST_CLASS
-LASSO_AUTHN_REQUEST_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>authn_request_envelope</FILE>
-<TITLE>LassoAuthnRequestEnvelope</TITLE>
-LassoAuthnRequestEnvelope
-LassoAuthnRequestEnvelopeClass
-lasso_authn_request_envelope_new
-lasso_authn_request_envelope_get_authnRequest
-lasso_authn_request_envelope_new_from_export
-<SUBSECTION Standard>
-LASSO_AUTHN_REQUEST_ENVELOPE
-LASSO_IS_AUTHN_REQUEST_ENVELOPE
-LASSO_TYPE_AUTHN_REQUEST_ENVELOPE
-lasso_authn_request_envelope_get_type
-LASSO_AUTHN_REQUEST_ENVELOPE_CLASS
-LASSO_IS_AUTHN_REQUEST_ENVELOPE_CLASS
-LASSO_AUTHN_REQUEST_ENVELOPE_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>authn_response</FILE>
-<TITLE>LassoAuthnResponse</TITLE>
-LassoAuthnResponse
-LassoAuthnResponseClass
-lasso_authn_response_new
-lasso_authn_response_new_from_export
-lasso_authn_response_get_status
-<SUBSECTION Standard>
-LASSO_AUTHN_RESPONSE
-LASSO_IS_AUTHN_RESPONSE
-LASSO_TYPE_AUTHN_RESPONSE
-lasso_authn_response_get_type
-LASSO_AUTHN_RESPONSE_CLASS
-LASSO_IS_AUTHN_RESPONSE_CLASS
-LASSO_AUTHN_RESPONSE_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>authn_response_envelope</FILE>
-<TITLE>LassoAuthnResponseEnvelope</TITLE>
-LassoAuthnResponseEnvelope
-LassoAuthnResponseEnvelopeClass
-lasso_authn_response_envelope_new
-lasso_authn_response_envelope_get_assertionConsumerServiceURL
-lasso_authn_response_envelope_get_authnResponse
-lasso_authn_response_envelope_new_from_export
-<SUBSECTION Standard>
-LASSO_AUTHN_RESPONSE_ENVELOPE
-LASSO_IS_AUTHN_RESPONSE_ENVELOPE
-LASSO_TYPE_AUTHN_RESPONSE_ENVELOPE
-lasso_authn_response_envelope_get_type
-LASSO_AUTHN_RESPONSE_ENVELOPE_CLASS
-LASSO_IS_AUTHN_RESPONSE_ENVELOPE_CLASS
-LASSO_AUTHN_RESPONSE_ENVELOPE_GET_CLASS
-</SECTION>
-
 <SECTION>
 <FILE>federation_termination_notification</FILE>
 <TITLE>LassoFederationTerminationNotification</TITLE>
@@ -1144,148 +1026,6 @@ LASSO_IS_LECP_CLASS
 LASSO_LECP_GET_CLASS
 </SECTION>
 
-<SECTION>
-<FILE>logout_request</FILE>
-<TITLE>LassoLogoutRequest</TITLE>
-LassoLogoutRequest
-LassoLogoutRequestClass
-lasso_logout_request_new
-lasso_logout_request_new_from_export
-<SUBSECTION Standard>
-LASSO_LOGOUT_REQUEST
-LASSO_IS_LOGOUT_REQUEST
-LASSO_TYPE_LOGOUT_REQUEST
-lasso_logout_request_get_type
-LASSO_LOGOUT_REQUEST_CLASS
-LASSO_IS_LOGOUT_REQUEST_CLASS
-LASSO_LOGOUT_REQUEST_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>logout_response</FILE>
-<TITLE>LassoLogoutResponse</TITLE>
-LassoLogoutResponse
-LassoLogoutResponseClass
-lasso_logout_response_new
-lasso_logout_response_new_from_export
-<SUBSECTION Standard>
-LASSO_LOGOUT_RESPONSE
-LASSO_IS_LOGOUT_RESPONSE
-LASSO_TYPE_LOGOUT_RESPONSE
-lasso_logout_response_get_type
-LASSO_LOGOUT_RESPONSE_CLASS
-LASSO_IS_LOGOUT_RESPONSE_CLASS
-LASSO_LOGOUT_RESPONSE_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>name_identifier_mapping_request</FILE>
-<TITLE>LassoNameIdentifierMappingRequest</TITLE>
-LassoNameIdentifierMappingRequest
-LassoNameIdentifierMappingRequestClass
-lasso_name_identifier_mapping_request_new
-lasso_name_identifier_mapping_request_new_from_query
-lasso_name_identifier_mapping_request_new_from_soap
-<SUBSECTION Standard>
-LASSO_NAME_IDENTIFIER_MAPPING_REQUEST
-LASSO_IS_NAME_IDENTIFIER_MAPPING_REQUEST
-LASSO_TYPE_NAME_IDENTIFIER_MAPPING_REQUEST
-lasso_name_identifier_mapping_request_get_type
-LASSO_NAME_IDENTIFIER_MAPPING_REQUEST_CLASS
-LASSO_IS_NAME_IDENTIFIER_MAPPING_REQUEST_CLASS
-LASSO_NAME_IDENTIFIER_MAPPING_REQUEST_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>name_identifier_mapping_response</FILE>
-<TITLE>LassoNameIdentifierMappingResponse</TITLE>
-LassoNameIdentifierMappingResponse
-LassoNameIdentifierMappingResponseClass
-lasso_name_identifier_mapping_response_new
-lasso_name_identifier_mapping_response_new_from_dump
-lasso_name_identifier_mapping_response_new_from_query
-lasso_name_identifier_mapping_response_new_from_request_soap
-lasso_name_identifier_mapping_response_new_from_soap
-lasso_name_identifier_mapping_response_new_from_request_query
-<SUBSECTION Standard>
-LASSO_NAME_IDENTIFIER_MAPPING_RESPONSE
-LASSO_IS_NAME_IDENTIFIER_MAPPING_RESPONSE
-LASSO_TYPE_NAME_IDENTIFIER_MAPPING_RESPONSE
-lasso_name_identifier_mapping_response_get_type
-LASSO_NAME_IDENTIFIER_MAPPING_RESPONSE_CLASS
-LASSO_IS_NAME_IDENTIFIER_MAPPING_RESPONSE_CLASS
-LASSO_NAME_IDENTIFIER_MAPPING_RESPONSE_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>register_name_identifier_request</FILE>
-<TITLE>LassoRegisterNameIdentifierRequest</TITLE>
-LassoRegisterNameIdentifierRequest
-LassoRegisterNameIdentifierRequestClass
-lasso_register_name_identifier_request_new
-lasso_register_name_identifier_request_new_from_export
-<SUBSECTION Standard>
-LASSO_REGISTER_NAME_IDENTIFIER_REQUEST
-LASSO_IS_REGISTER_NAME_IDENTIFIER_REQUEST
-LASSO_TYPE_REGISTER_NAME_IDENTIFIER_REQUEST
-lasso_register_name_identifier_request_get_type
-LASSO_REGISTER_NAME_IDENTIFIER_REQUEST_CLASS
-LASSO_IS_REGISTER_NAME_IDENTIFIER_REQUEST_CLASS
-LASSO_REGISTER_NAME_IDENTIFIER_REQUEST_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>register_name_identifier_response</FILE>
-<TITLE>LassoRegisterNameIdentifierResponse</TITLE>
-LassoRegisterNameIdentifierResponse
-LassoRegisterNameIdentifierResponseClass
-lasso_register_name_identifier_response_new
-lasso_register_name_identifier_response_new_from_export
-<SUBSECTION Standard>
-LASSO_REGISTER_NAME_IDENTIFIER_RESPONSE
-LASSO_IS_REGISTER_NAME_IDENTIFIER_RESPONSE
-LASSO_TYPE_REGISTER_NAME_IDENTIFIER_RESPONSE
-lasso_register_name_identifier_response_get_type
-LASSO_REGISTER_NAME_IDENTIFIER_RESPONSE_CLASS
-LASSO_IS_REGISTER_NAME_IDENTIFIER_RESPONSE_CLASS
-LASSO_REGISTER_NAME_IDENTIFIER_RESPONSE_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>request</FILE>
-<TITLE>LassoRequest</TITLE>
-LassoRequest
-LassoRequestClass
-lasso_request_new
-lasso_request_new_from_export
-<SUBSECTION Standard>
-LASSO_REQUEST
-LASSO_IS_REQUEST
-LASSO_TYPE_REQUEST
-lasso_request_get_type
-LASSO_REQUEST_CLASS
-LASSO_IS_REQUEST_CLASS
-LASSO_REQUEST_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>response</FILE>
-<TITLE>LassoResponse</TITLE>
-LassoResponse
-LassoResponseClass
-lasso_response_new
-lasso_response_new_from_export
-<SUBSECTION Standard>
-LASSO_RESPONSE
-LASSO_IS_RESPONSE
-LASSO_TYPE_RESPONSE
-lasso_response_get_type
-LASSO_RESPONSE_CLASS
-LASSO_IS_RESPONSE_CLASS
-LASSO_RESPONSE_GET_CLASS
-</SECTION>
-
-
 <SECTION>
 <FILE>defederation</FILE>
 <TITLE>LassoDefederation</TITLE>
@@ -1423,31 +1163,6 @@ LASSO_IS_PROFILE_CLASS
 LASSO_PROFILE_GET_CLASS
 </SECTION>
 
-<SECTION>
-<FILE>server</FILE>
-<TITLE>LassoServer</TITLE>
-LassoServer
-LassoServerClass
-lasso_server_new
-lasso_server_new_from_dump
-lasso_server_add_provider
-lasso_server_copy
-lasso_server_dump
-lasso_server_destroy
-lasso_server_get_first_providerID
-lasso_server_get_provider
-lasso_server_get_provider_ref
-lasso_server_get_providerID_from_hash
-<SUBSECTION Standard>
-LASSO_SERVER
-LASSO_IS_SERVER
-LASSO_TYPE_SERVER
-lasso_server_get_type
-LASSO_SERVER_CLASS
-LASSO_IS_SERVER_CLASS
-LASSO_SERVER_GET_CLASS
-</SECTION>
-
 <SECTION>
 <FILE>session</FILE>
 LassoSessionPrivate
@@ -1475,33 +1190,7 @@ LASSO_IS_SESSION_CLASS
 LASSO_SESSION_GET_CLASS
 </SECTION>
 
-
-<SECTION>
-<FILE>saml</FILE>
-</SECTION>
-
-<SECTION>
-<FILE>lib</FILE>
-</SECTION>
-
 <SECTION>
 <FILE>strings</FILE>
 </SECTION>
 
-<SECTION>
-<FILE>tools</FILE>
-lasso_build_random_sequence
-lasso_build_unique_id
-lasso_doc_get_node_content
-lasso_g_ptr_array_index
-lasso_get_current_time
-lasso_get_pem_file_type
-lasso_get_public_key_from_pem_cert_file
-lasso_query_get_value
-lasso_query_to_dict
-lasso_query_verify_signature
-lasso_sha1
-lasso_str_escape
-lasso_str_sign
-lasso_str_unescape
-</SECTION>
diff --git a/docs/reference/lasso.sgml b/docs/reference/lasso.sgml
index 042189a2..d6b3dad8 100644
--- a/docs/reference/lasso.sgml
+++ b/docs/reference/lasso.sgml
@@ -40,7 +40,6 @@
 <!ENTITY LassoSamlpRequest SYSTEM "sgml/samlp_request.sgml">
 <!ENTITY LassoLibAuthnContext SYSTEM "sgml/lib_authn_context.sgml">
 <!ENTITY LassoLibAuthenticationStatement SYSTEM "sgml/lib_authentication_statement.sgml">
-<!ENTITY lasso-export SYSTEM "sgml/export.sgml">
 <!ENTITY lasso-lasso SYSTEM "sgml/lasso.sgml">
 <!ENTITY lasso-version SYSTEM "sgml/version.sgml">
 <!ENTITY LassoFederation SYSTEM "sgml/federation.sgml">
@@ -106,15 +105,26 @@ implement Liberty Alliance specifications.
 
     &LassoNode;
     &LassoLibAssertion;
+    &LassoLibAuthenticationStatement;
+    &LassoLibAuthnContext;
     &LassoLibAuthnRequest;
     &lasso-LassoLibAuthnRequestEnvelope;
     &LassoLibAuthnResponse;
     &lasso-LassoLibAuthnResponseEnvelope;
+    &LassoLibFederationTerminationNotification;
     &LassoLibIDPEntries;
     &LassoLibIDPEntry;
     &LassoLibIDPList;
+    &LassoLibLogoutRequest;
+    &LassoLibLogoutResponse;
+    &LassoLibNameIdentifierMappingRequest;
+    &LassoLibNameIdentifierMappingResponse;
+    &LassoLibRegisterNameIdentifierRequest;
+    &LassoLibRegisterNameIdentifierResponse;
     &LassoLibRequestAuthnContext;
     &LassoLibScoping;
+    &LassoLibStatusResponse;
+    &LassoLibSubject;
     &LassoSamlAdvice;
     &LassoSamlAssertion;
     &LassoSamlAudienceRestrictionCondition;
@@ -123,29 +133,22 @@ implement Liberty Alliance specifications.
     &LassoSamlConditionAbstract;
     &LassoSamlConditions;
     &LassoSamlNameIdentifier;
-    &LassoSamlStatementAbstract;
-    &LassoSamlSubject;
-    &LassoSamlSubjectConfirmation;
-    &LassoSamlSubjectLocality;
-    &LassoSamlSubjectStatementAbstract;
+    &LassoSamlpRequest;
     &LassoSamlpRequestAbstract;
     &LassoSamlpResponse;
     &LassoSamlpResponseAbstract;
     &LassoSamlpStatus;
     &LassoSamlpStatusCode;
-    &LassoLibLogoutRequest;
-    &LassoLibFederationTerminationNotification;
-    &LassoLibLogoutResponse;
-    &LassoLibNameIdentifierMappingRequest;
-    &LassoLibNameIdentifierMappingResponse;
-    &LassoLibRegisterNameIdentifierRequest;
-    &LassoLibRegisterNameIdentifierResponse;
-    &LassoLibStatusResponse;
-    &LassoLibSubject;
-    &LassoSamlpRequest;
-    &LassoLibAuthnContext;
-    &LassoLibAuthenticationStatement;
-    &lasso-export;
+    &LassoSamlStatementAbstract;
+    &LassoSamlSubject;
+    &LassoSamlSubjectConfirmation;
+    &LassoSamlSubjectLocality;
+    &LassoSamlSubjectStatementAbstract;
+  </chapter>
+
+  <chapter id="misc">
+    <title>Misc</title>
+
     &lasso-lasso;
     &lasso-version;
   </chapter>
diff --git a/docs/reference/tmpl/provider.sgml b/docs/reference/tmpl/provider.sgml
index 647442ec..ec78bfad 100644
--- a/docs/reference/tmpl/provider.sgml
+++ b/docs/reference/tmpl/provider.sgml
@@ -6,7 +6,7 @@ Representation of a provider
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+It holds all the data about a provider.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -73,98 +73,98 @@ Representation of a provider
 @Returns: 
 
 
-<!-- ##### FUNCTION lasso_provider_get_metadata_one ##### -->
+<!-- ##### FUNCTION lasso_provider_new_from_dump ##### -->
 <para>
 
 </para>
 
-@provider: 
-@name: 
+@dump: 
 @Returns: 
 
 
-<!-- ##### FUNCTION lasso_provider_get_metadata_list ##### -->
+<!-- ##### FUNCTION lasso_provider_accept_http_method ##### -->
 <para>
 
 </para>
 
 @provider: 
-@name: 
+@remote_provider: 
+@protocol_type: 
+@http_method: 
+@initiate_profile: 
 @Returns: 
 
 
-<!-- ##### FUNCTION lasso_provider_load_metadata ##### -->
+<!-- ##### FUNCTION lasso_provider_get_base64_succint_id ##### -->
 <para>
 
 </para>
 
 @provider: 
-@metadata: 
 @Returns: 
 
 
-<!-- ##### FUNCTION lasso_provider_new_from_dump ##### -->
+<!-- ##### FUNCTION lasso_provider_get_first_http_method ##### -->
 <para>
 
 </para>
 
-@dump: 
+@provider: 
+@remote_provider: 
+@protocol_type: 
 @Returns: 
 
 
-<!-- ##### FUNCTION lasso_provider_verify_signature ##### -->
+<!-- ##### FUNCTION lasso_provider_get_metadata_list ##### -->
 <para>
 
 </para>
 
 @provider: 
-@message: 
-@id_attr_name: 
-@format: 
+@name: 
 @Returns: 
 
 
-<!-- ##### FUNCTION lasso_provider_get_first_http_method ##### -->
+<!-- ##### FUNCTION lasso_provider_get_metadata_one ##### -->
 <para>
 
 </para>
 
 @provider: 
-@remote_provider: 
-@protocol_type: 
+@name: 
 @Returns: 
 
 
-<!-- ##### FUNCTION lasso_provider_accept_http_method ##### -->
+<!-- ##### FUNCTION lasso_provider_has_protocol_profile ##### -->
 <para>
 
 </para>
 
 @provider: 
-@remote_provider: 
 @protocol_type: 
-@http_method: 
-@initiate_profile: 
+@protocol_profile: 
 @Returns: 
 
 
-<!-- ##### FUNCTION lasso_provider_has_protocol_profile ##### -->
+<!-- ##### FUNCTION lasso_provider_load_metadata ##### -->
 <para>
 
 </para>
 
 @provider: 
-@protocol_type: 
-@protocol_profile: 
+@metadata: 
 @Returns: 
 
 
-<!-- ##### FUNCTION lasso_provider_get_base64_succint_id ##### -->
+<!-- ##### FUNCTION lasso_provider_verify_signature ##### -->
 <para>
 
 </para>
 
 @provider: 
+@message: 
+@id_attr_name: 
+@format: 
 @Returns: 
 
 
diff --git a/docs/reference/tmpl/server.sgml b/docs/reference/tmpl/server.sgml
new file mode 100644
index 00000000..b0635af1
--- /dev/null
+++ b/docs/reference/tmpl/server.sgml
@@ -0,0 +1,120 @@
+<!-- ##### SECTION Title ##### -->
+LassoServer
+
+<!-- ##### SECTION Short_Description ##### -->
+Representation of the current server
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+It holds the data about a provider, other providers it knows, which
+certificates to use, etc.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT LassoServer ##### -->
+<para>
+
+</para>
+
+@providers: 
+@services: 
+@private_key: 
+@secret_key: 
+@certificate: 
+@signature_method: 
+
+<!-- ##### FUNCTION lasso_server_new ##### -->
+<para>
+
+</para>
+
+@metadata: 
+@private_key: 
+@secret_key: 
+@certificate: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_server_new_from_dump ##### -->
+<para>
+
+</para>
+
+@dump: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_server_add_provider ##### -->
+<para>
+
+</para>
+
+@server: 
+@role: 
+@metadata: 
+@public_key: 
+@ca_cert_chain: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_server_add_service ##### -->
+<para>
+
+</para>
+
+@server: 
+@service_type: 
+@service_endpoint: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_server_destroy ##### -->
+<para>
+
+</para>
+
+@server: 
+
+
+<!-- ##### FUNCTION lasso_server_dump ##### -->
+<para>
+
+</para>
+
+@server: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_server_get_first_providerID ##### -->
+<para>
+
+</para>
+
+@server: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_server_get_provider ##### -->
+<para>
+
+</para>
+
+@server: 
+@providerID: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_server_get_providerID_from_hash ##### -->
+<para>
+
+</para>
+
+@server: 
+@b64_hash: 
+@Returns: 
+
+
-- 
cgit