Kea  2.1.7-git
isc::dhcp::Parser6Context Class Reference

Evaluation context, an interface to the expression evaluation. More...

#include <parser_context.h>

Public Types

enum  ParserContext {
  NO_KEYWORD, CONFIG, DHCP6, INTERFACES_CONFIG,
  SANITY_CHECKS, LEASE_DATABASE, HOSTS_DATABASE, DATABASE_TYPE,
  DATABASE_ON_FAIL, MAC_SOURCES, HOST_RESERVATION_IDENTIFIERS, HOOKS_LIBRARIES,
  SUBNET6, SHARED_NETWORK, RESERVATION_MODE, OPTION_DEF,
  OPTION_DATA, CLIENT_CLASSES, EXPIRED_LEASES_PROCESSING, SERVER_ID,
  DUID_TYPE, CONTROL_SOCKET, DHCP_QUEUE_CONTROL, DHCP_MULTI_THREADING,
  POOLS, PD_POOLS, RESERVATIONS, RELAY,
  LOGGERS, OUTPUT_OPTIONS, DHCP_DDNS, NCR_PROTOCOL,
  NCR_FORMAT, REPLACE_CLIENT_NAME, CONFIG_CONTROL, CONFIG_DATABASE,
  COMPATIBILITY
}
 Defines syntactic contexts for lexical tie-ins. More...
 
enum  ParserType {
  PARSER_JSON, PARSER_DHCP6, SUBPARSER_DHCP6, PARSER_INTERFACES,
  PARSER_SUBNET6, PARSER_POOL6, PARSER_PD_POOL, PARSER_HOST_RESERVATION,
  PARSER_OPTION_DEFS, PARSER_OPTION_DEF, PARSER_OPTION_DATA, PARSER_HOOKS_LIBRARY,
  PARSER_DHCP_DDNS, PARSER_CONFIG_CONTROL
}
 Defines currently supported scopes. More...
 

Public Member Functions

 Parser6Context ()
 Default constructor. More...
 
virtual ~Parser6Context ()
 destructor More...
 
const std::string contextName ()
 Get the syntactic context name. More...
 
void enter (const ParserContext &ctx)
 Enter a new syntactic context. More...
 
void error (const isc::dhcp::location &loc, const std::string &what, size_t pos=0)
 Error handler. More...
 
void error (const std::string &what)
 Error handler. More...
 
void includeFile (const std::string &filename)
 Divert input to an include file. More...
 
void leave ()
 Leave a syntactic context. More...
 
isc::data::Element::Position loc2pos (isc::dhcp::location &loc)
 Converts bison's position to one understandable by isc::data::Element. More...
 
isc::data::ElementPtr parseFile (const std::string &filename, ParserType parser_type)
 Run the parser on the file specified. More...
 
isc::data::ElementPtr parseString (const std::string &str, ParserType parser_type)
 Run the parser on the string specified. More...
 
void require (const std::string &name, isc::data::Element::Position open_loc, isc::data::Element::Position close_loc)
 Check if a required parameter is present. More...
 
void scanEnd ()
 Method called after the last tokens are scanned. More...
 
void scanFileBegin (FILE *f, const std::string &filename, ParserType type)
 Method called before scanning starts on a file. More...
 
void scanStringBegin (const std::string &str, ParserType type)
 Method called before scanning starts on a string. More...
 
void unique (const std::string &name, isc::data::Element::Position loc)
 Check if a parameter is already present. More...
 
void warnAboutExtraCommas (const isc::dhcp::location &loc)
 Warning for extra commas. More...
 
void warning (const isc::dhcp::location &loc, const std::string &what)
 Warning handler. More...
 

Static Public Member Functions

static void fatal (const std::string &what)
 Fatal error handler. More...
 

Public Attributes

ParserContext ctx_
 Current syntactic context. More...
 
std::string file_
 File name. More...
 
std::vector< std::string > files_
 File name stack. More...
 
isc::dhcp::location loc_
 Location of the current token. More...
 
std::vector< isc::dhcp::location > locs_
 Location stack. More...
 
FILE * sfile_
 sFile (aka FILE) More...
 
std::vector< FILE * > sfiles_
 sFile (aka FILE) stack More...
 
std::vector< isc::data::ElementPtrstack_
 JSON elements being parsed. More...
 
std::vector< struct yy_buffer_state * > states_
 Lexer state stack. More...
 

Detailed Description

Evaluation context, an interface to the expression evaluation.

Definition at line 35 of file dhcp6/parser_context.h.

Member Enumeration Documentation

◆ ParserContext

Defines syntactic contexts for lexical tie-ins.

Enumerator
NO_KEYWORD 

This one is used in pure JSON mode.

Used while parsing top level (that contains Dhcp6)

CONFIG 

Used while parsing content of Dhcp6.

DHCP6 
INTERFACES_CONFIG 

Used while parsing Dhcp6/interfaces structures.

SANITY_CHECKS 

Sanity checks.

LEASE_DATABASE 

Used while parsing Dhcp6/lease-database structures.

HOSTS_DATABASE 

Used while parsing Dhcp6/hosts-database[s] structures.

DATABASE_TYPE 

Used while parsing Dhcp6/*-database/type.

DATABASE_ON_FAIL 

Used while parsing Dhcp6/*-database/on-fail.

MAC_SOURCES 

Used while parsing Dhcp6/mac-sources structures.

HOST_RESERVATION_IDENTIFIERS 

Used while parsing Dhcp6/host-reservation-identifiers.

HOOKS_LIBRARIES 

Used while parsing Dhcp6/hooks-libraries.

SUBNET6 

Used while parsing Dhcp6/Subnet6 structures.

SHARED_NETWORK 

Used while parsing shared-networks structures.

RESERVATION_MODE 

Used while parsing Dhcp6/reservation-mode.

OPTION_DEF 

Used while parsing Dhcp6/option-def structures.

OPTION_DATA 

Used while parsing Dhcp6/option-data, Dhcp6/subnet6/option-data or anywhere option-data is present (client classes, host reservations and possibly others).

CLIENT_CLASSES 

Used while parsing Dhcp6/client-classes structures.

EXPIRED_LEASES_PROCESSING 

Used while parsing Dhcp6/expired-leases-processing.

SERVER_ID 

Used while parsing Dhcp6/server-id structures.

DUID_TYPE 

Used while parsing Dhcp6/server-id/type structures.

CONTROL_SOCKET 

Used while parsing Dhcp6/control-socket structures.

DHCP_QUEUE_CONTROL 

Used while parsing Dhcp6/dhcp-queue-control structures.

DHCP_MULTI_THREADING 

Used while parsing Dhcp6/multi-threading structures.

POOLS 

Used while parsing Dhcp6/subnet6/pools structures.

PD_POOLS 

Used while parsing Dhcp6/subnet6/pd-pools structures.

RESERVATIONS 

Used while parsing Dhcp6/reservations structures.

RELAY 

Used while parsing Dhcp6/subnet6/relay structures.

LOGGERS 

Used while parsing Dhcp6/loggers structures.

OUTPUT_OPTIONS 

Used while parsing Dhcp6/loggers/output_options structures.

DHCP_DDNS 

Used while parsing Dhcp6/dhcp-ddns.

NCR_PROTOCOL 

Used while parsing Dhcp6/dhcp-ddns/ncr-protocol.

NCR_FORMAT 

Used while parsing Dhcp6/dhcp-ddns/ncr-format.

REPLACE_CLIENT_NAME 

Used while parsing Dhcp6/dhcp-ddns/replace-client-name.

CONFIG_CONTROL 

Used while parsing Dhcp6/config-control.

CONFIG_DATABASE 

Used while parsing config-control/config-databases.

COMPATIBILITY 

Used while parsing compatibility parameters.

Definition at line 233 of file dhcp6/parser_context.h.

◆ ParserType

Defines currently supported scopes.

Dhcp6Parser is able to parse several types of scope. Usually, when it parses a config file, it expects the data to have a map with Dhcp6 in it and all the parameters within that Dhcp6 map. However, sometimes the parser is expected to parse only a subset of that information. For example, it may be asked to parse a structure that is host-reservation only, without the global 'Dhcp6' or 'reservations' around it. In such case the parser is being told to start parsing as PARSER_HOST_RESERVATION6.

Enumerator
PARSER_JSON 

This parser will parse the content as generic JSON.

PARSER_DHCP6 

This parser will parse the content as Dhcp6 config wrapped in a map (that's the regular config file)

SUBPARSER_DHCP6 

This parser will parse the content of Dhcp6 (without outer { } and without "Dhcp6").

It is mostly used in unit-tests as most of the unit-tests do not define the outer map and Dhcp6 entity, just the contents of it.

PARSER_INTERFACES 

This will parse the input as interfaces content.

PARSER_SUBNET6 

This will parse the input as Subnet6 content.

PARSER_POOL6 

This will parse the input as pool6 content.

PARSER_PD_POOL 

This will parse the input as pd-pool content.

PARSER_HOST_RESERVATION 

This will parse the input as host-reservation.

PARSER_OPTION_DEFS 

This will parse the input option definitions (for tests).

PARSER_OPTION_DEF 

This will parse the input as option definition.

PARSER_OPTION_DATA 

This will parse the input as option data.

PARSER_HOOKS_LIBRARY 

This will parse the input as hooks-library.

PARSER_DHCP_DDNS 

This will parse the input as dhcp-ddns. (D2 client config)

PARSER_CONFIG_CONTROL 

This will parse the input as config-control.

Definition at line 49 of file dhcp6/parser_context.h.

Constructor & Destructor Documentation

◆ Parser6Context()

isc::dhcp::Parser6Context::Parser6Context ( )

Default constructor.

Definition at line 22 of file dhcp6/parser_context.cc.

◆ ~Parser6Context()

isc::dhcp::Parser6Context::~Parser6Context ( )
virtual

destructor

Definition at line 27 of file dhcp6/parser_context.cc.

Member Function Documentation

◆ contextName()

◆ enter()

void isc::dhcp::Parser6Context::enter ( const ParserContext ctx)

Enter a new syntactic context.

Entering a new syntactic context is useful in several ways. First, it allows the parser to avoid conflicts. Second, it allows the lexer to return different tokens depending on context (e.g. if "renew-timer" string is detected, the lexer will return STRING token if in JSON mode or RENEW_TIMER if in DHCP6 mode. Finally, the syntactic context allows the error message to be more descriptive if the input string does not parse properly.

Parameters
ctxthe syntactic context to enter into

Definition at line 132 of file dhcp6/parser_context.cc.

References ctx_.

Referenced by isc::dhcp::Dhcp6Parser::parse().

◆ error() [1/2]

void isc::dhcp::Parser6Context::error ( const isc::dhcp::location &  loc,
const std::string &  what,
size_t  pos = 0 
)

Error handler.

Note
The optional position for an error in a string begins by 1 so the caller should add 1 to the position of the C++ string.
Parameters
loclocation within the parsed file where the problem was experienced.
whatstring explaining the nature of the error.
posoptional position for in string errors.
Exceptions
Dhcp6ParseError

Definition at line 72 of file dhcp6/parser_context.cc.

References isc_throw.

◆ error() [2/2]

void isc::dhcp::Parser6Context::error ( const std::string &  what)

Error handler.

This is a simplified error reporting tool for possible future cases when the Dhcp6Parser is not able to handle the packet.

Parameters
whatstring explaining the nature of the error.
Exceptions
Dhcp6ParseError

Definition at line 83 of file dhcp6/parser_context.cc.

References isc_throw.

◆ fatal()

void isc::dhcp::Parser6Context::fatal ( const std::string &  what)
static

Fatal error handler.

This is for should not happen but fatal errors. Used by YY_FATAL_ERROR macro so required to be static.

Parameters
whatstring explaining the nature of the error.
Exceptions
Dhcp6ParseError

Definition at line 88 of file dhcp6/parser_context.cc.

References isc_throw.

Referenced by leave().

◆ includeFile()

void Parser6Context::includeFile ( const std::string &  filename)

Divert input to an include file.

Parameters
filenamefile to be included

Definition at line 6590 of file dhcp6_lexer.cc.

References BEGIN, isc::db::fatal, INITIAL, and YY_CURRENT_BUFFER.

◆ leave()

void isc::dhcp::Parser6Context::leave ( )

Leave a syntactic context.

Exceptions
isc::Unexpectedif unbalanced

Definition at line 138 of file dhcp6/parser_context.cc.

References ctx_, and fatal().

Referenced by isc::dhcp::Dhcp6Parser::parse().

+ Here is the call graph for this function:

◆ loc2pos()

isc::data::Element::Position isc::dhcp::Parser6Context::loc2pos ( isc::dhcp::location &  loc)

Converts bison's position to one understandable by isc::data::Element.

Convert a bison location into an element position (take the begin, the end is lost)

Parameters
loclocation in bison format
Returns
Position in format accepted by Element

Definition at line 93 of file dhcp6/parser_context.cc.

Referenced by isc::dhcp::Dhcp6Parser::parse().

◆ parseFile()

isc::data::ElementPtr isc::dhcp::Parser6Context::parseFile ( const std::string &  filename,
ParserType  parser_type 
)

Run the parser on the file specified.

This method parses specified file. Depending on the value of parser_type, parser may either check only that the input is valid JSON, or may do more specific syntax checking. See ParserType for supported syntax checkers.

Parameters
filenamefile to be parsed
parser_typespecifies expected content (usually DHCP6 or generic JSON)
Returns
Element structure representing parsed text.

Definition at line 37 of file dhcp6/parser_context.cc.

References isc_throw, isc::dhcp::Dhcp6Parser::parse(), scanEnd(), scanFileBegin(), isc::dhcp::Dhcp6Parser::set_debug_level(), and stack_.

Referenced by isc::dhcp::ControlledDhcpv6Srv::loadConfigFile().

+ Here is the call graph for this function:

◆ parseString()

isc::data::ElementPtr isc::dhcp::Parser6Context::parseString ( const std::string &  str,
ParserType  parser_type 
)

Run the parser on the string specified.

This method parses specified string. Depending on the value of parser_type, parser may either check only that the input is valid JSON, or may do more specific syntax checking. See ParserType for supported syntax checkers.

Parameters
strstring to be parsed
parser_typespecifies expected content (usually DHCP6 or generic JSON)
Returns
Element structure representing parsed text.

Definition at line 31 of file dhcp6/parser_context.cc.

References scanStringBegin().

+ Here is the call graph for this function:

◆ require()

void isc::dhcp::Parser6Context::require ( const std::string &  name,
isc::data::Element::Position  open_loc,
isc::data::Element::Position  close_loc 
)

Check if a required parameter is present.

Check if a required parameter is present in the map at the top of the stack and raise an error when it is not.

Parameters
namename of the parameter expected to be present
open_loclocation of the opening curly bracket
close_loclocation of the closing curly bracket
Exceptions
Dhcp6ParseError

Definition at line 101 of file dhcp6/parser_context.cc.

References contextName(), isc_throw, and stack_.

Referenced by isc::dhcp::Dhcp6Parser::parse().

+ Here is the call graph for this function:

◆ scanEnd()

void Parser6Context::scanEnd ( )

Method called after the last tokens are scanned.

Definition at line 6569 of file dhcp6_lexer.cc.

Referenced by parseFile().

◆ scanFileBegin()

void Parser6Context::scanFileBegin ( FILE *  f,
const std::string &  filename,
ParserType  type 
)

Method called before scanning starts on a file.

Parameters
fstdio FILE pointer
filenamefile to be parsed
typespecifies expected content

Definition at line 6547 of file dhcp6_lexer.cc.

References isc::db::fatal, and yy_flex_debug.

Referenced by parseFile().

◆ scanStringBegin()

void Parser6Context::scanStringBegin ( const std::string &  str,
ParserType  type 
)

Method called before scanning starts on a string.

Parameters
strstring to be parsed
typespecifies expected content

Definition at line 6529 of file dhcp6_lexer.cc.

References isc::db::fatal, and yy_flex_debug.

Referenced by parseString().

◆ unique()

void isc::dhcp::Parser6Context::unique ( const std::string &  name,
isc::data::Element::Position  loc 
)

Check if a parameter is already present.

Check if a parameter is already present in the map at the top of the stack and raise an error when it is.

Parameters
namename of the parameter to check
loclocation of the current parameter
Exceptions
Dhcp6ParseError

Definition at line 115 of file dhcp6/parser_context.cc.

References contextName(), ctx_, isc_throw, NO_KEYWORD, and stack_.

Referenced by isc::dhcp::Dhcp6Parser::parse().

+ Here is the call graph for this function:

◆ warnAboutExtraCommas()

void isc::dhcp::Parser6Context::warnAboutExtraCommas ( const isc::dhcp::location &  loc)

Warning for extra commas.

Parameters
loclocation within the parsed file of the extra comma
Exceptions
ParseError

Definition at line 240 of file dhcp6/parser_context.cc.

References warning().

Referenced by isc::dhcp::Dhcp6Parser::parse().

+ Here is the call graph for this function:

◆ warning()

void isc::dhcp::Parser6Context::warning ( const isc::dhcp::location &  loc,
const std::string &  what 
)

Warning handler.

Parameters
loclocation within the parsed file where the problem was experienced
whatstring explaining the nature of the error
Exceptions
ParseError

Definition at line 231 of file dhcp6/parser_context.cc.

References isc::dhcp::DHCP6_CONFIG_SYNTAX_WARNING, isc::dhcp::dhcp6_logger, and LOG_WARN.

Referenced by warnAboutExtraCommas().

Member Data Documentation

◆ ctx_

ParserContext isc::dhcp::Parser6Context::ctx_

Current syntactic context.

Definition at line 378 of file dhcp6/parser_context.h.

Referenced by contextName(), enter(), leave(), isc::dhcp::Dhcp6Parser::parse(), and unique().

◆ file_

std::string isc::dhcp::Parser6Context::file_

File name.

Definition at line 350 of file dhcp6/parser_context.h.

◆ files_

std::vector<std::string> isc::dhcp::Parser6Context::files_

File name stack.

Definition at line 353 of file dhcp6/parser_context.h.

◆ loc_

isc::dhcp::location isc::dhcp::Parser6Context::loc_

Location of the current token.

The lexer will keep updating it. This variable will be useful for logging errors.

Definition at line 359 of file dhcp6/parser_context.h.

◆ locs_

std::vector<isc::dhcp::location> isc::dhcp::Parser6Context::locs_

Location stack.

Definition at line 362 of file dhcp6/parser_context.h.

◆ sfile_

FILE* isc::dhcp::Parser6Context::sfile_

sFile (aka FILE)

Definition at line 368 of file dhcp6/parser_context.h.

◆ sfiles_

std::vector<FILE*> isc::dhcp::Parser6Context::sfiles_

sFile (aka FILE) stack

This is a stack of files. Typically there's only one file (the one being currently parsed), but there may be more if one file includes another.

Definition at line 375 of file dhcp6/parser_context.h.

◆ stack_

std::vector<isc::data::ElementPtr> isc::dhcp::Parser6Context::stack_

JSON elements being parsed.

Definition at line 104 of file dhcp6/parser_context.h.

Referenced by isc::dhcp::Dhcp6Parser::parse(), parseFile(), require(), and unique().

◆ states_

std::vector<struct yy_buffer_state*> isc::dhcp::Parser6Context::states_

Lexer state stack.

Definition at line 365 of file dhcp6/parser_context.h.


The documentation for this class was generated from the following files: