cmdline.c

dvbsnoop is a DVB/MPEG stream analyzer program. The program can be used to sniff, monitor, debug, d

     if      (!strcmp (argv[i],"-demux")) opt->devDemux = argv[++i];
     else if (!strcmp (argv[i],"-dvr")) opt->devDvr = argv[++i];
     else if (!strcmp (argv[i],"-frontend")) opt->devFE = argv[++i];
     else if (!strcmp (argv[i],"-adapter")) opt->dvbAdapterNr = str2i(argv[++i]);
     else if (!strcmp (argv[i],"-devnr")) opt->dvbDeviceNr  = str2i(argv[++i]);
     else if (!strcmp (argv[i],"-maxdmx")) opt->max_dmx_filter = str2i(argv[++i]);
     else if (!strcmp (argv[i],"-crc")) opt->crc = 1;
     else if (!strcmp (argv[i],"-nocrc")) opt->crc = 0;
     else if (!strcmp (argv[i],"-softcrc")) opt->soft_crc = 1;
     else if (!strcmp (argv[i],"-nosoftcrc")) opt->soft_crc = 0;
     else if (!strcmp (argv[i],"-sync")) opt->packet_header_sync = 1;
     else if (!strcmp (argv[i],"-nosync")) opt->packet_header_sync = 0;
     else if (!strcmp (argv[i],"-n")) opt->rd_packet_count = str2i(argv[++i]);
     else if (!strcmp (argv[i],"-N")) opt->dec_packet_count = str2i(argv[++i]);
     else if (!strcmp (argv[i],"-b")) opt->binary_out = 1;
     else if (!strcmp (argv[i],"-ph")) opt->printhex = str2i(argv[++i]);
     else if (!strcmp (argv[i],"-pd")) opt->printdecode = str2i(argv[++i]);
     else if (!strcmp (argv[i],"-npd")) opt->printdecode = 0;
     else if (!strcmp (argv[i],"-hideproginfo")) opt->hide_copyright= 1;
     else if (!strcmp (argv[i],"-timeout")) opt->timeout_ms = str2i(argv[++i]);
     else if (!strcmp (argv[i],"-buffersize")) opt->rd_buffer_size = str2i(argv[++i]) * 1024;
     else if (!strcmp (argv[i],"-tf")) opt->time_mode = FULL_TIME;
     else if (!strcmp (argv[i],"-td")) opt->time_mode = DELTA_TIME;
     else if (!strcmp (argv[i],"-tn")) opt->time_mode = NO_TIME;
     else if (!strcmp (argv[i],"-hexdumpbuffer")) opt->buffer_hexdump = 1;
     else if (!strcmp (argv[i],"-nohexdumpbuffer")) opt->buffer_hexdump = 0;
     else if (!strcmp (argv[i],"-nph")) opt->buffer_hexdump = 0;  // old option  use -ph and -nhdb/-hdb
     else if (!strcmp (argv[i],"-help")) opt->help = 1;
     else if (!strcmp (argv[i],"-privateprovider")) opt->privateProviderStr = argv[++i];
     else if (!strcmp (argv[i],"-tssubdecode")) opt->ts_subdecode = 1;
     else if (!strcmp (argv[i],"-allsections")) opt->rd_all_sections = 1;
     else if (!strcmp (argv[i],"-f")) {
	 opt->filterLen = str2barray(argv[++i], opt->filter, DMX_FILTER_SIZE);
     } else if (!strcmp (argv[i],"-m")) {
	 int x = str2barray(argv[++i], opt->mask, DMX_FILTER_SIZE);
	 if (x<0) opt->filterLen = -1;
     } else if (!strcmp (argv[i],"-tsraw")) {
	 opt->ts_raw_mode = 1;
	 opt->pid = DUMMY_PID;			// dummy to avoid usage output
     } else if (!strcmp (argv[i],"-spiderpid")) {
	 opt->spider_pid = 1;
	 opt->rd_packet_count = 1;
     } else if (!strcmp (argv[i],"-of")) {
     	 opt->binary_out = 1;
	 opt->outPidFile = argv[++i];		// binary output filename
	 if (!opt->outPidFile) opt->outPidFile = ""; 
	 if (!strcmp(opt->outPidFile,"-"))  opt->outPidFile = "/dev/stdout"; 
     } else if (!strcmp (argv[i],"-if")) {
	 opt->inpPidFile = argv[++i];		// input filename
	 if (!opt->inpPidFile) opt->inpPidFile = ""; 
	 if (!strcmp(opt->inpPidFile,"-"))  opt->inpPidFile = "/dev/stdin"; 
	 opt->pid = DUMMY_PID;			// dummy to avoid usage output
     } else if (!strcmp (argv[i],"-s")) {
         s = argv[++i];
	 if (!s ) s = ""; 
         if (!strcmp (s,"sec")) opt->packet_mode = SECT;
         else if (!strcmp (s,"ts")) opt->packet_mode = TS;
         else if (!strcmp (s,"pes")) opt->packet_mode = PES;
         else if (!strcmp (s,"ps")) opt->packet_mode = PS;	// ProgramStream
         else if (!strcmp (s,"bandwidth")) opt->packet_mode = PIDBANDWIDTH;
         else if (!strcmp (s,"pidscan")) {
		 	opt->packet_mode = PIDSCAN;
			opt->pid = DUMMY_PID;	// dummy to avoid usage output
	 } else if (!strcmp (s,"signal")) {
		 	opt->packet_mode = SCAN_FE_SIGNAL;
			opt->pid = DUMMY_PID;	// dummy to avoid usage output
	 } else if (!strcmp (s,"feinfo")) {
		 	opt->packet_mode = SCAN_FE_INFO;
			opt->pid = DUMMY_PID;	// dummy to avoid usage output
	 } else opt->help = 1;
     } else if (isdigit (argv[i][0])) {
         opt->pid = str2i(argv[i]); 	// PID
	 if (opt->pid > MAX_PID) opt->help = 1;
     } else {
         opt->help = 1;
         break;
     }

  } // while


  /*
   -- standard if no print decode or printhex given
  */

  if (opt->printhex    < 0) opt->printhex = 4;
  if (opt->printdecode < 0) opt->printdecode = 7;


  if (opt->filterLen < 0) {
    printf("Error: Illegal filter/mask value: use e.g. 0x4F or 0x12.5F.2A. etc...\n");
    return(0); 
  }




  //
  // -- set default DVB devices 
  // -- (e.g. printed by help)
  //

  set_DVB_device (strDEV_DEMUX,    DEMUX_DEVICE_MASK,    DVB_STD_ADAPTER_NR, DVB_STD_DEVICE_NR);
  set_DVB_device (strDEV_DVR,      DVR_DEVICE_MASK,      DVB_STD_ADAPTER_NR, DVB_STD_DEVICE_NR);
  set_DVB_device (strDEV_FRONTEND, FRONTEND_DEVICE_MASK, DVB_STD_ADAPTER_NR, DVB_STD_DEVICE_NR);


 
  //
  //  -- help ?  (and return abort)
  //

  if (opt->help) {
    usage ();
    printf("\nKnown private providers for private sections and descriptors:\n");
    list_PRIVATE_ProviderStrs ();
    return(0); 
  } 


  //
  // -- set private scope id strings (if specified)
  //

  if (opt->privateProviderStr) {
     set_PRIVATE_ProviderStr (opt->privateProviderStr);
  }



  //
  // -- set DVB devices  demux, dvr and frontend
  // -- if not set by cmdline, set by 1.) default, 2.) adapterNr & deviceNr
  //

  if (   opt->dvbAdapterNr < 0 || opt->dvbAdapterNr > 9
      || opt->dvbDeviceNr  < 0 || opt->dvbDeviceNr  > 9)  {
    printf("Error: Illegal DVB adapter/card number or illegal DVB device number. \n");
    return(0); 
  }

  if (!opt->devDemux) {
  	opt->devDemux = set_DVB_device (strDEV_DEMUX, DEMUX_DEVICE_MASK,
  					opt->dvbAdapterNr, opt->dvbDeviceNr);
  }
  if (!opt->devDvr) {
  	opt->devDvr   = set_DVB_device (strDEV_DVR, DVR_DEVICE_MASK,
  					opt->dvbAdapterNr, opt->dvbDeviceNr);
  }
  if (!opt->devFE) {
  	opt->devFE    = set_DVB_device (strDEV_FRONTEND, FRONTEND_DEVICE_MASK,
  					opt->dvbAdapterNr, opt->dvbDeviceNr);
  }



  //
  // -- PID check
  //

  if ((argc==1) || ((opt->pid > MAX_PID) && (opt->pid != DUMMY_PID)) ) {
    title ();
    printf("For help type 'dvbsnoop -help' ...\n");
    return(0); 
  } 


 return 1;
}





//
// -- Get pointer to cmdline Option structure
//
OPTION *getOptionPtr (void)
{
   return opt_ptr;
}





static void title (void)
{
    printf("dvbsnoop  - a dvb/mpeg2 stream analyzer tool\n");
    printf("Version: %s/api-%d  (%s %s)\n",
		    DVBSNOOP_VERSION,DVB_API_VERSION,__DATE__,__TIME__);
    printf("         %s  \n",DVBSNOOP_URL);
    printf("         %s  \n",DVBSNOOP_COPYRIGHT);
    printf("\n");
}



static void usage (void)
{
    title ();

    printf("Usage:   dvbsnoop [opts] pid \n");
    printf("Options:  \n");
    printf("   -s type:    snoop type or mode <type>  [-s sec]\n");
    printf("                   stream type: sec, pes, ps or ts\n");
    printf("                   or special scan type:\n");
    printf("                         pidscan = transponder pid scan,\n");
    printf("                         bandwidth = data rate statistics for pid\n");
    printf("                         signal = signal rate statistics \n");
    printf("                         feinfo = frontend information\n");
    printf("                 stream type or pidscan\n");
    printf("   -demux device: demux device [%s]\n",strDEV_DEMUX);
    printf("   -dvr device:   dvr device [%s]\n",strDEV_DVR);
    printf("   -frontend device: frontend   device [%s]\n",strDEV_FRONTEND);
    printf("   -adapter n:    select dvb adapter/card no. <n> using default path\n");
    printf("   -devnr n:      select device no. <n> using default dvb adapter/card\n");
// $$$ TODO  -of cmd option
//  printf("   -of file:     output file, writes binary <file> (implies -b)\n");
//  printf("                  <file>=\"-\" = /dev/stdout \n");
    printf("   -if file:     input file, reads from binary <file> instead of demux device \n");
    printf("                  <file>=\"-\" = /dev/stdin \n");
    printf("   -timeout ms:  section/signal read timeout in <ms> msec. [-timeout 0]\n");
    printf("   -maxdmx n:    max demux filters <n> to use in pidscan mode (0=max) [-maxdmx 0]\n");
    printf("   -buffersize kb: read buffersize in KBytes  [-buffersize 0]\n");
    printf("                 (0 = use default read buffer size)\n");
    printf("   -f filter:    filtervalue for 'sec' demux [-f 0]\n");
    printf("                 multibyte filter syntax: 0x1A.34.56.7F.01\n");
    printf("   -m mask:      maskvalue for 'sec' demux [-m 0]\n");
    printf("                 multibyte mask syntax: 0x1A.00.F6.55\n");
    printf("   -crc:         CRC check when reading 'sec' [-nocrc]\n");
    printf("   -nocrc:       no CRC check when reading 'sec' [-nocrc]\n");
    printf("   -softcrc:     internal soft CRC check when reading 'sec' [-nosoftcrc]\n");
    printf("   -nosoftcrc:   no internal soft CRC check when reading 'sec' [-nosoftcrc]\n");
    printf("   -sync:        simple packet header sync when reading 'ts' or 'pes' [-snyc]\n");
    printf("   -nosync:      no header sync when reading 'ts' or 'pes' [-snyc]\n");
    printf("   -n count:     receive/read max. <count> packets (0=no limit) [-n 0]\n");
    printf("   -N count:     decode max. <count> packets (0=no limit) [-N 0]\n");
    printf("                 this will limit -n, e.g. when using soft filters.\n");
    printf("   -spiderpid:   snoop referenced section pids (sets -n 1) \n");
// $$$ TODO
//    printf("   -allsections: read all sections in sequence on pid (limited by -n ..) \n");
    printf("   -tssubdecode: sub-decode sections or pes from ts stream decoding\n");
    printf("   -tsraw:       read raw/full TS in TS snoop mode\n");
    printf("   -b:           binary output of packets (disables other output)\n");
    printf("   -ph mode:     data hex dump mode, modes: [-ph 4]\n");
    printf("                   0=none, 1=hexdump, 2=hex line 3=ascii line 4=hexdump2\n");
    printf("   -hexdumpbuffer:   print hex dump of read buffer [-hexdumpbuffer]\n");
    printf("   -nohexdumpbuffer: don't print hex dump of read buffer [-hexdumpbuffer]\n");
    printf("   -nph:         don't print hex dump of buffer [= -nohexdumpbuffer]\n");
    printf("   -pd verbose:  print stream decode (verbose level 0..9) [-pd 7]\n");
    printf("   -npd:         don't print decoded stream (= -pd 0) \n");
    printf("   -t[n|d|f]:    print timestamp (no, delta, full) [-tf] \n");
    printf("   -privateprovider id: set provider <id> string for decoding private tables and descriptors\n");
    printf("   -hideproginfo: hide copyright and program info header at program start\n");
    printf("   -help:        this usage info...\n");
    printf("\n");
    

 return;
}




static char *set_DVB_device (char *str, const char *path_mask, int adapter, int devnr)
{
  sprintf (str, path_mask, adapter, devnr);
  return str;
}






// $$$ TODO  commandline handling needs a redesign