Skip to content

Instantly share code, notes, and snippets.

@codyhanson
Last active February 12, 2017 21:18
Show Gist options
  • Save codyhanson/d52069cf04054705dac2175b46ec0e4e to your computer and use it in GitHub Desktop.
Save codyhanson/d52069cf04054705dac2175b46ec0e4e to your computer and use it in GitHub Desktop.
NETCDL Certifier Implementation Standards
NETCDL Certifier Implementation Standards
This document, while not a formal RFC, should serve as a guide for implemen-
tors of future NETCDL Certifier Software. The key words ”MUST”, ”MUST NOT”,
”REQUIRED”, ”SHALL”, ”SHALL NOT”, ”SHOULD”, ”SHOULD NOT”, ”REC-
OMMENDED”, ”MAY”, and ”OPTIONAL” in this document are to be interpreted
as described in RFC2119[7].
A NETCDL certifier MUST recognize and parse a body of text that conforms to the official NETCDL grammar specification.
If a parse error occurs, the certifier SHOULD inform the user the cause of the error, so that they may fix it.
During certification the certifier SHALL evaluate every assertion in the input document.
The certifier MAY carry out the assertions in any order.
The certifier SHOULD attempt to minimize the total assertion time, or the performance impact on the network, according to user preferences.
After certification activities have completed, the certifier SHALL provide the user with a report of certification, by some means.
The report MUST show overall success, where greater than zero failures results in failed certification, and zero failures results in passed certification.
The report SHOULD indicate to the user the cause of the failures.
After certification activities have completed, the software SHOULD release any resources acquired, such as DHCP leases, slots on bandwidth limited servers, and other such limited resources.
Certifiers MAY provide a graphical user interface for the user.
Certifiers MAY be loaded onto dedicated hardware platforms that carry out certification functions.
Certifier implementations MAY be proprietary in nature.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment