check-syntax-enabled

DS server instance configuration (SER) property check-syntax-enabled

Description

The behavior of a Directory Server instance is configured according to server properties such as check-syntax-enabled.

Characteristic	Value
Syntax	`on \| off`
Default Value	`off`
Is readable	Yes
Is modifiable	Yes
Is multi-valued	No

In the preceding table, syntax values shown in lower case or partly in lower case are literal values. Those shown in upper case are syntax types, as described in server(5DSCONF).

This property specifies whether the server checks that attribute values being updated have valid syntax. The server logs an error message when encountering an invalid value and prevents the update. When this property is set to on, the server checks updates to attribute values defined as Boolean, DN, Directory String, Generalized Time, IA5 String, INTEGER, or Telephone Number syntax. This behavior holds both for offline import and for normal write operations.

By default, syntax checking is off. When syntax checking is on, all import and update operations are checked. Directory Manager (directory super user) cannot bypass syntax checking.

Syntax is not checked on existing entries in the database. To clean up existing data, dump the database to LDIF, turn syntax checking on, and reload the database. Data that violates the syntax is visible in the errors log, and can be corrected and reloaded. You can also repair existing bad data by deleting or replacing the bad value using an LDAP client. If syntax checking is on, when a database is reloaded from LDIF, invalid syntax values are skipped and recorded in the errors log. Valid syntax values are reloaded.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWdsee7
Stability Level	Evolving