Update README and deprecate mdb-hexdump

This commit is contained in:
Evan Miller 2021-08-04 15:33:43 -04:00
parent e88e3cc7e7
commit 12a888988d
2 changed files with 26 additions and 9 deletions

View File

@ -12,11 +12,11 @@ The major pieces of MDB Tools are:
### libmdb ### libmdb
The core library that allows access to MDB files programatically. The core library that allows access to MDB files programatically. See [mdbtools.h](./include/mdbtools.h.in) for the complete API.
### libmdbsql ### libmdbsql
Builds on libmdb to provide a SQL engine (aka Jet) Builds on libmdb to provide a SQL engine (aka Jet). See [mdbsql.h](./include/mdbsql.h) for the complete API.
### utils ### utils
@ -32,17 +32,24 @@ Provides command line utilities, including:
| `mdb-count` | A simple count of number of rows in a table, to be used in shell scripts and ETL pipelines. | | `mdb-count` | A simple count of number of rows in a table, to be used in shell scripts and ETL pipelines. |
| `mdb-sql` | A simple SQL engine (also used by ODBC and gmdb). | | `mdb-sql` | A simple SQL engine (also used by ODBC and gmdb). |
| `mdb-queries` | List and print queries stored in the database. | | `mdb-queries` | List and print queries stored in the database. |
| `mdb-hexdump`\* | (in src/extras) Simple hex dump utility to look at mdb files. |
| `mdb-array`\* | Export data in an MDB database table to a C array. |
| `mdb-header`\* | Generates a C header to be used in exporting mdb data to a C prog. |
| `mdb-parsecsv`\* | Generates a C program given a CSV file made with mdb-export. |
\* Deprecated
See the man page of each program for usage instructions.
The src/utils directory also contains a number of debugging tools, intended for developers. They are:
| `prcat` | Prints the catalog table from an mdb file. | | `prcat` | Prints the catalog table from an mdb file. |
| `prkkd` | Dump of information about design view data given the offset to it. | | `prkkd` | Dump of information about design view data given the offset to it. |
| `prtable` | Dump of a table definition. | | `prtable` | Dump of a table definition. |
| `prdata` | Dump of the data given a table name. | | `prdata` | Dump of the data given a table name. |
| `prole` | Dump of ole columns given a table name and sargs. | | `prole` | Dump of ole columns given a table name and sargs. |
| `mdb-hexdump` | (in src/extras) Simple hex dump utility that I've been using to look at mdb files. |
| `mdb-array` | Export data in an MDB database table to a C array.\* |
| `mdb-header` | Generates a C header to be used in exporting mdb data to a C prog.\* |
| `mdb-parsecsv` | Generates a C program given a CSV file made with mdb-export.\* |
\* Deprecated These tools are not installed on the host system.
### odbc ### odbc
@ -50,7 +57,7 @@ An ODBC driver for use with unixODBC or iODBC driver manager. Allows one to use
### gmdb2 ### gmdb2
The Gnome MDB File Viewer and debugger. Alpha quality, moved to [mdbtools/gmdb2](https://github.com/mdbtools/gmdb2). The Gnome MDB File Viewer and debugger. Recently ported to GTK+3 and moved to [mdbtools/gmdb2](https://github.com/mdbtools/gmdb2).
## License ## License
@ -95,6 +102,12 @@ apt install mdbtools
brew install mdbtools brew install mdbtools
``` ```
### MacPorts
```bash
port install mdbtools
```
### From source ### From source
If you have cloned the Git repository, you will first need to generate the If you have cloned the Git repository, you will first need to generate the

View File

@ -33,6 +33,10 @@ int main(int argc, char **argv)
fprintf(stderr, "Usage: mdb-dump <filename> [<page number>]\n\n"); fprintf(stderr, "Usage: mdb-dump <filename> [<page number>]\n\n");
exit(1); exit(1);
} }
fputs("mdb-hexdump is deprecated and will disappear in a future version of mdbtools.\n", stderr);
fputs("Please drop us a line if you have any use of it.\n", stderr);
fputs("See https://github.com/mdbtools/mdbtools/issues/197\n", stderr);
fputs("\n", stderr);
if (argc>2) { if (argc>2) {
if (!strncmp(argv[2],"0x",2)) { if (!strncmp(argv[2],"0x",2)) {
for (i=2;i<strlen(argv[2]);i++) { for (i=2;i<strlen(argv[2]);i++) {
@ -89,4 +93,4 @@ int main(int argc, char **argv)
exit(0); exit(0);
} }
/** @}*/ /** @}*/