File Insert Retriever

Access local files and preserve static sections within the file. More...

Access local files and preserve static sections within the file.

SYNOPSYS

Retriever URI:

fileinsert:filepath

i.e.

fileinsert:/etc/dhcpd.conf

DESCRIPTION

The file insert retriever is based on the Backup File retriever and behaves identical for read operations. When writing to a file via file insert, however, the driver requires the target file to contain a section that is surrounded by the two lines

##BEGIN director maintained section

and

##END director maintained section

The parts of the file before the BEGIN marker and after the END marker are copied as is from the existing target file. The part between the two markers is replaced by whatever has to be written into the file.

The above magic strings need not necessarily be located at the start of a line. Since usually they will be placed within a comment some arbitrary comment start / comment end characters may be added at the front and/or at the end of the marker.