2 Copyright (c) 2005-2009, 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.
28 \version $Id: klvwalk.cpp,v 1.18 2010/11/15 17:04:13 jhurst Exp $
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-2009 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] [-v] <input-file> [<input-file2> ...]\n\
85 -h | -help - Show help\n\
86 -r - When KLV data is an MXF OPAtom file, display OPAtom headers\n\
87 -v - Verbose. Prints informative messages to stderr\n\
88 -V - Show version information\n\
90 NOTES: o There is no option grouping, all options must be distinct arguments.\n\
91 o All option arguments must be separated from the option by whitespace.\n\
92 \n", PROGRAM_NAME, PROGRAM_NAME);
102 bool error_flag; // true if the given options are in error or not complete
103 bool version_flag; // true if the version display option was selected
104 bool help_flag; // true if the help display option was selected
105 bool verbose_flag; // true if the informative messages option was selected
106 bool read_mxf_flag; // true if the -r option was selected
107 FileList_t inFileList; // File to operate on
109 CommandOptions(int argc, const char** argv) :
110 error_flag(true), version_flag(false), help_flag(false), verbose_flag(false), read_mxf_flag(false)
112 for ( int i = 1; i < argc; i++ )
115 if ( (strcmp( argv[i], "-help") == 0) )
121 if ( argv[i][0] == '-' && isalpha(argv[i][1]) && argv[i][2] == 0 )
123 switch ( argv[i][1] )
125 case 'h': help_flag = true; break;
126 case 'r': read_mxf_flag = true; break;
127 case 'V': version_flag = true; break;
128 case 'v': verbose_flag = true; break;
131 fprintf(stderr, "Unrecognized option: %s\n", argv[i]);
137 if ( argv[i][0] != '-' )
138 inFileList.push_back(argv[i]);
142 fprintf(stderr, "Unrecognized option: %s\n", argv[i]);
148 if ( help_flag || version_flag )
151 if ( inFileList.empty() )
153 fputs("Input filename(s) required.\n", stderr);
162 //---------------------------------------------------------------------------------------------------
166 main(int argc, const char** argv)
168 CommandOptions Options(argc, argv);
170 if ( Options.version_flag )
173 if ( Options.help_flag )
176 if ( Options.version_flag || Options.help_flag )
179 if ( Options.error_flag )
181 fprintf(stderr, "There was a problem. Type %s -h for help.\n", PROGRAM_NAME);
185 FileList_t::iterator fi;
186 Result_t result = RESULT_OK;
188 for ( fi = Options.inFileList.begin(); ASDCP_SUCCESS(result) && fi != Options.inFileList.end(); fi++ )
190 if (Options.verbose_flag)
191 fprintf(stderr, "Opening file %s\n", ((*fi).c_str()));
193 if ( Options.read_mxf_flag ) // dump MXF
195 Kumu::FileReader Reader;
196 const Dictionary* Dict = &DefaultCompositeDict();
197 ASDCP::MXF::OPAtomHeader Header(Dict);
199 result = Reader.OpenRead((*fi).c_str());
201 if ( ASDCP_SUCCESS(result) )
202 result = Header.InitFromFile(Reader);
204 if ( ASDCP_SUCCESS(result) )
207 if ( ASDCP_SUCCESS(result) && Header.m_RIP.PairArray.size() > 2 )
209 MXF::Array<MXF::RIP::Pair>::const_iterator pi = Header.m_RIP.PairArray.begin();
211 for ( pi++; pi != Header.m_RIP.PairArray.end() && ASDCP_SUCCESS(result); pi++ )
213 result = Reader.Seek((*pi).ByteOffset);
215 if ( ASDCP_SUCCESS(result) )
217 MXF::Partition TmpPart(Dict);
218 result = TmpPart.InitFromFile(Reader);
220 if ( ASDCP_SUCCESS(result) && TmpPart.BodySID > 0 )
221 TmpPart.Dump(stdout);
226 if ( ASDCP_SUCCESS(result) )
228 ASDCP::MXF::OPAtomIndexFooter Index(Dict);
229 result = Reader.Seek(Header.FooterPartition);
231 if ( ASDCP_SUCCESS(result) )
233 Index.m_Lookup = &Header.m_Primer;
234 result = Index.InitFromFile(Reader);
237 if ( ASDCP_SUCCESS(result) )
241 if ( ASDCP_SUCCESS(result) )
242 Header.m_RIP.Dump(stdout);
246 Kumu::FileReader Reader;
250 result = Reader.OpenRead((*fi).c_str());
252 if ( ASDCP_SUCCESS(result) )
253 result = KP.InitFromFile(Reader);
255 while ( ASDCP_SUCCESS(result) )
257 fprintf(stdout, "@0x%08qx: ", pos);
258 KP.Dump(stdout, DefaultCompositeDict(), true);
260 result = KP.InitFromFile(Reader);
263 if( result == RESULT_ENDOFFILE )
268 if ( ASDCP_FAILURE(result) )
270 fputs("Program stopped on error.\n", stderr);
272 if ( result != RESULT_FAIL )
274 fputs(result, stderr);