2 Copyright (c) 2005-2018, John Hurst
5 Redistribution and use in source and binary forms, with or without
6 modification, are permitted provided that the following conditions
8 1. Redistributions of source code must retain the above copyright
9 notice, this list of conditions and the following disclaimer.
10 2. Redistributions in binary form must reproduce the above copyright
11 notice, this list of conditions and the following disclaimer in the
12 documentation and/or other materials provided with the distribution.
13 3. The name of the author may not be used to endorse or promote products
14 derived from this software without specific prior written permission.
16 THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17 IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18 OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19 IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20 INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22 DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23 THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25 THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
39 #include <sys/types.h>
42 using namespace ASDCP;
43 using Kumu::DefaultLogSink;
46 //------------------------------------------------------------------------------------------
48 // command line option parser class
50 static const char* PROGRAM_NAME = "klvwalk"; // program name for messages
51 typedef std::list<std::string> FileList_t;
53 // Increment the iterator, test for an additional non-option command line argument.
54 // Causes the caller to return if there are no remaining arguments or if the next
55 // argument begins with '-'.
56 #define TEST_EXTRA_ARG(i,c) if ( ++i >= argc || argv[(i)][0] == '-' ) \
58 fprintf(stderr, "Argument not found for option -%c.\n", (c)); \
64 banner(FILE* stream = stdout)
68 Copyright (c) 2005-2013 John Hurst\n\
69 %s is part of the asdcplib DCP tools package.\n\
70 asdcplib may be copied only under the terms of the license found at\n\
71 the top of every file in the asdcplib distribution kit.\n\n\
72 Specify the -h (help) option for further information about %s\n\n",
73 PROGRAM_NAME, ASDCP::Version(), PROGRAM_NAME, PROGRAM_NAME);
78 usage(FILE* stream = stdout)
81 USAGE: %s [-r|-p] [-v] <input-file> [<input-file2> ...]\n\
85 -h | -help - Show help\n\
86 -r - When KLV data is an MXF OPAtom or OP 1a file, display headers\n\
87 -p - Display partition headers by walking the RIP\n\
88 -v - Verbose. Prints informative messages to stderr\n\
89 -V - Show version information\n\
91 NOTES: o There is no option grouping, all options must be distinct arguments.\n\
92 o All option arguments must be separated from the option by whitespace.\n\
93 \n", PROGRAM_NAME, PROGRAM_NAME);
103 bool error_flag; // true if the given options are in error or not complete
104 bool version_flag; // true if the version display option was selected
105 bool help_flag; // true if the help display option was selected
106 bool verbose_flag; // true if the informative messages option was selected
107 bool read_mxf_flag; // true if the -r option was selected
108 bool walk_parts_flag; // true if the -p option was selected
109 FileList_t inFileList; // File to operate on
111 CommandOptions(int argc, const char** argv) :
112 error_flag(true), version_flag(false), help_flag(false),
113 verbose_flag(false), read_mxf_flag(false), walk_parts_flag(false)
115 for ( int i = 1; i < argc; i++ )
118 if ( (strcmp( argv[i], "-help") == 0) )
124 if ( argv[i][0] == '-' && isalpha(argv[i][1]) && argv[i][2] == 0 )
126 switch ( argv[i][1] )
128 case 'h': help_flag = true; break;
129 case 'r': read_mxf_flag = true; break;
130 case 'p': walk_parts_flag = true; break;
131 case 'V': version_flag = true; break;
132 case 'v': verbose_flag = true; break;
135 fprintf(stderr, "Unrecognized option: %s\n", argv[i]);
141 if ( argv[i][0] != '-' )
142 inFileList.push_back(argv[i]);
146 fprintf(stderr, "Unrecognized option: %s\n", argv[i]);
152 if ( help_flag || version_flag )
155 if ( inFileList.empty() )
157 fputs("Input filename(s) required.\n", stderr);
166 //---------------------------------------------------------------------------------------------------
170 main(int argc, const char** argv)
172 CommandOptions Options(argc, argv);
174 if ( Options.version_flag )
177 if ( Options.help_flag )
180 if ( Options.version_flag || Options.help_flag )
183 if ( Options.error_flag )
185 fprintf(stderr, "There was a problem. Type %s -h for help.\n", PROGRAM_NAME);
189 FileList_t::iterator fi;
190 Result_t result = RESULT_OK;
192 for ( fi = Options.inFileList.begin(); ASDCP_SUCCESS(result) && fi != Options.inFileList.end(); fi++ )
194 if (Options.verbose_flag)
195 fprintf(stderr, "Opening file %s\n", ((*fi).c_str()));
197 if ( Options.read_mxf_flag ) // dump MXF
199 Kumu::FileReader Reader;
200 const Dictionary* Dict = &DefaultCompositeDict();
201 ASDCP::MXF::OP1aHeader Header(Dict);
202 ASDCP::MXF::RIP RIP(Dict);
204 result = Reader.OpenRead(*fi);
206 if ( ASDCP_SUCCESS(result) )
208 result = MXF::SeekToRIP(Reader);
210 if ( ASDCP_SUCCESS(result) )
212 result = RIP.InitFromFile(Reader);
213 ui32_t test_s = RIP.PairArray.size();
215 if ( ASDCP_FAILURE(result) )
217 DefaultLogSink().Error("File contains no RIP\n");
220 else if ( RIP.PairArray.empty() )
222 DefaultLogSink().Error("RIP contains no Pairs.\n");
229 DefaultLogSink().Error("read_mxf SeekToRIP failed: %s\n", result.Label());
233 if ( ASDCP_SUCCESS(result) )
234 result = Header.InitFromFile(Reader);
236 if ( ASDCP_SUCCESS(result) )
239 if ( ASDCP_SUCCESS(result) && RIP.PairArray.size() > 2 )
241 MXF::RIP::const_pair_iterator pi = RIP.PairArray.begin();
243 for ( pi++; pi != RIP.PairArray.end() && ASDCP_SUCCESS(result); pi++ )
245 result = Reader.Seek((*pi).ByteOffset);
247 if ( ASDCP_SUCCESS(result) )
249 MXF::Partition TmpPart(Dict);
250 result = TmpPart.InitFromFile(Reader);
252 if ( ASDCP_SUCCESS(result) && TmpPart.BodySID > 0 )
253 TmpPart.Dump(stdout);
258 if ( ASDCP_SUCCESS(result) )
260 ASDCP::MXF::OPAtomIndexFooter Index(Dict);
261 result = Reader.Seek(Header.FooterPartition);
263 if ( ASDCP_SUCCESS(result) )
265 Index.m_Lookup = &Header.m_Primer;
266 result = Index.InitFromFile(Reader);
269 if ( ASDCP_SUCCESS(result) )
273 if ( ASDCP_SUCCESS(result) )
276 else if ( Options.walk_parts_flag )
278 Kumu::FileReader Reader;
279 const Dictionary* Dict = &DefaultCompositeDict();
280 ASDCP::MXF::OP1aHeader Header(Dict);
281 ASDCP::MXF::RIP RIP(Dict);
283 result = Reader.OpenRead((*fi).c_str());
285 if ( ASDCP_SUCCESS(result) )
286 result = MXF::SeekToRIP(Reader);
288 if ( ASDCP_SUCCESS(result) )
290 result = RIP.InitFromFile(Reader);
291 ui32_t test_s = RIP.PairArray.size();
293 if ( ASDCP_FAILURE(result) )
295 DefaultLogSink().Error("File contains no RIP\n");
298 else if ( RIP.PairArray.empty() )
300 DefaultLogSink().Error("RIP contains no Pairs.\n");
307 DefaultLogSink().Error("walk_parts SeekToRIP failed: %s\n", result.Label());
310 if ( ASDCP_SUCCESS(result) )
314 MXF::RIP::const_pair_iterator i;
315 for ( i = RIP.PairArray.begin(); i != RIP.PairArray.end(); ++i )
317 Reader.Seek(i->ByteOffset);
318 MXF::Partition plain_part(Dict);
319 plain_part.InitFromFile(Reader);
321 if ( plain_part.ThisPartition != i->ByteOffset )
323 DefaultLogSink().Error("ThisPartition value error: wanted=%qu, got=%qu\n",
324 plain_part.ThisPartition, i->ByteOffset);
333 Kumu::FileReader Reader;
337 result = Reader.OpenRead((*fi).c_str());
339 if ( ASDCP_SUCCESS(result) )
340 result = KP.InitFromFile(Reader);
342 while ( ASDCP_SUCCESS(result) )
344 fprintf(stdout, "@0x%08llx: ", pos);
345 KP.Dump(stdout, DefaultCompositeDict(), true);
347 result = KP.InitFromFile(Reader);
350 if( result == RESULT_ENDOFFILE )
355 if ( ASDCP_FAILURE(result) )
357 fputs("Program stopped on error.\n", stderr);
359 if ( result != RESULT_FAIL )
361 fputs(result, stderr);