diff --git a/LICENSE b/LICENSE index e69de29..f073357 100644 --- a/LICENSE +++ b/LICENSE @@ -0,0 +1,15 @@ + + Copyright 2015 Candice Quates + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + diff --git a/README b/README index e69de29..c03270d 100644 --- a/README +++ b/README @@ -0,0 +1,28 @@ +nullfinder +========== + +Small program for extracting data from sparse files with unknown structures +(like GPU memory dumps.) + +nullfinder uses blocks of nulls as breaks between data. It can then extract +data at the addresses between nulls. It will continue to glob nulls together, +allowing a map to be made. By default the program uses 8 nulls as a marker. + +compile: +g++ -std=c++0x -o nullf nullfinder.cc map_file.cc error.cc + +usage: +./nullf [--extract] datafile + +(output snippet) + +71fffc nulls begin 722800 end +722800 data begins 294001f ends +2940017 nulls begin 2940023 end + +The program will also extract the data fragments into location-marked files +using the --extract option. + +bugs: +An argument to change the null-block length exists but does not work. +