Ns_RollFile

Overview

Rename a file and increment its backup number

Syntax

    int Ns_RollFile(
    	char *filename,
    	int   backupMax
    );

Description

The Ns_RollFile function renames the specified file, incrementing its backup number (file extension). The backupMax argument must be between 1 and 1000. Ns_RollFile returns a status of NS_ERROR or NS_OK.