Get file extended operation

Edit online

The get file extended operation explains its use with the server and provides the results.

Description
This extended operation returns the contents of a file on the server.
Request
OID
1.3.18.0.2.12.73
Syntax
RequestValue ::= SEQUENCE {
        fileNumber	INTEGER {Other(0), 
                         V3.ibm.at(1), V3.ibm.oc(2), 
                         V3.user.at(3), V3.user.oc(4), 
                         V3.config.at(5), V3.config.at(6), 
                         V3.system.at(7), V3.system.oc(8), 
                         V3.modifiedschema(9), V3.ldapsyntaxes(10),
                         V3.matchingrules(11),
                         KeyRingFile(12), KeyDBFile(13)};
       fileName	String;
}
Response
OID
1.3.18.0.2.12.73
Syntax
ResponseValue ::= SEQUENCE {
        length    INTEGER, // The length of the file.
        lines     OCTET STRING // The lines from the file. 
}
Behavior
A client uses the get file request to retrieve the contents of schema-related files or SSL-related files from the server. If the connection between the client and server is not over SSL, the SSL-related files are not returned.
The Primary Directory Administrator is enabled to call the extended operation.
Note: If the extended operation is called by a user who does not have the required access, LDAP_INSUFFICIENT_ACCESS is returned.
This extended operation has the following possible return codes:
  • LDAP_SUCCESS - If the file was successfully read.
  • LDAP_PROTOCOL_ERROR - If there is an error in the format of the request.
  • LDAP_INSUFFICIENT_ACCESS – If the request is from users other than the administrators.
  • LDAP_OPERATIONS_ERROR - Internal Server error.
  • LDAP_NO_SUCH_OBJECT - The requested file does not exist.

This extended operation is not supported by the Administration Server.

Scope
The extended operation affects only the current operation.
Auditing
The following information is audited for this extended operation: 
File: [fileName | V3.ibm.at | V3.ibm.oc |
       V3.user.at | V3.user.oc |
       V3.config.at | V3.config.at |
       V3.system.at | V3.system.oc |
       V3.modifiedschema | V3.ldapsyntaxes |
       V3.matchingrules]