butil
Description
The Btrieve utility butil is used at a command prompt for manipulation and administration of Btrieve files and their data. You can us butil to perform the following actions:
•Starts and stops continuous operations for use in performing server backups.
•Recovers changes made to a file between the time of the last backup and a system failure.
•Imports and exports ASCII, unformatted, and SDF sequential data.
•Copies data between files.
•Preloads or flushes the file page cache.
•Returns MicroKernel Engine version information.
Continuous operation is a MicroKernel Engine feature that enables you to back up files while they are in use by PSQL-based applications. Two maintenance commands, startbu and endbu, begin and end continuous operation on a file or set of files.
Synopsis
butil
-cache sourceFile
-CLONE outputFile sourceFile [/O<owner | *>] [/pagecompresson | /pagecompressoff] [/recordcompresson | /recordcompressoff] [/UIDuname /PWDpword [/DBdbname]]
-CLROWNER sourceFile /O<owner | *> [/UIDuname /PWDpword [/DBdbname]]
@commandFile [commandOutputFile]
-COPY sourceFile outputFile
[/O< owner1 | *> [/O<owner2 | *>]] [/UIDuname /PWDpword [/DBdbname]]
-CREATE outputFile descriptionFile [< Y | N >] [/UIDuname /PWDpword [/DBdbname]]
-DROP sourceFile < keyNumber | SYSKEY >
[/O<owner | *>] [/UIDuname /PWDpword [/DBdbname]]
-ENDBU < /A | sourceFile | @listFile > [/UIDuname /PWDpword [/DBdbname]]
-INDEX sourceFile indexFile descriptionFile
[ /O<owner | *>] [/UIDuname /PWDpword [/DBdbname]]
-LOAD unformattedFile outputFile [/O<owner |*>] [/UIDuname /PWDpword [/DBdbname]]
-purge sourceFile
-RECOVER sourceFile unformattedFile [/O<owner |*>] [/UIDuname /PWDpword [/DBdbname]]
-ROLLFWD <sourceFile | volume | drive | @listFile>
[</L[dumpFile] | /W[dumpFile]> [/T<dataLength>]
[/E<keyLength>] [/H] [/V] [/O<ownerList | owner> | *]]
[/A] [/UIDuname /PWDpword [/DBdbname]]
-SAVE sourceFile unformattedFile
[Y indexFile | N <keyNumber | -1>] [/O<owner1 | *>
[/O<owner2 | *>]] [/UIDuname /PWDpword [/DBdbname]]
-SETOWNER sourceFile /O<owner | *> level [/UIDuname /PWDpword [/DBdbname]]
-SINDEX sourceFile <descriptionFile | SYSKEY> [keyNumber] [/O<owner | *>] [/UIDuname /PWDpword [/DBdbname]]
-STARTBU <sourceFile | @listFile> [/UIDuname /PWDpword [/DBdbname]]
-STAT <sourceFile> [/O<owner | *>] [/UIDuname /PWDpword [/DBdbname]]
-VER
Note On Linux or macOS distributions, all slash options use a hyphen instead of a slash. For example, the /O options for butil -copy is -O, as in butil -copy -O.
Options
Maintenance tool command options are not case sensitive unless the option is a file name.
If you run butil without specifying a command option or with an invalid command option, a usage message is printed. The usage message indicates that there is an optional /S command line argument to butil. This argument is ignored on Linux, macOS, or Raspbian.
For a complete discussion of the commands, options, and examples, see
Btrieve Command Line Maintenance Tool (Butil) in
Advanced Operations Guide.
See Also
•syslogd in Linux or macOS man pages
•Btrieve API Guide, which describes the API for the MicroKernel Engine.