Distribution/doc/txt/oscam.conf.txt

   1 oscam.conf(5)                                                        File Formats Manual                                                       oscam.conf(5)
   2
   3
   4
   5 NAME
   6        oscam.conf - main configuration file for OSCam
   7
   8 SYNOPSIS
   9        The  main  configuration  file  for  OSCam contains global parameters such as debugging, logging, monitor, protocols and anti-cascading.  sections in
  10        oscam.conf are nonrecurring. The [global] section is required. All other sections are optional.
  11
  12 DESCRIPTIONS
  13    The [global] section
  14        nice = -20..+20
  15           system priority, default:99
  16
  17        pidfile = filename
  18           set PID file, default:none
  19
  20        logfile = [filename][;syslog][;stdout]
  21           logging targets, default:/var/log/oscam.log. You can define a maximum of one filename and additionally to log to stdout or syslog  (you  can  also
  22           only log to stdout or syslog and omit the filename).
  23        PP initial_debuglevel = level
  24           set initial debug level for OSCam start, default:0
  25        PP sysloghost = hostname
  26           set remote syslog host, default:none
  27
  28        syslogport = port
  29           set TCP/IP port for remote syslog host, default:none
  30
  31        ecmfmt = format
  32           define ECM log format, default:c&p/i/s/l:h
  33
  34           possible variables:
  35
  36             c = CAID
  37             d = PID
  38             e = CSP hash
  39             g = ID of origin gbox peer
  40             h = checksum
  41             i = channel ID
  42             j = distance of gbox hops
  43             l = length
  44             o = ONID
  45             p = provider ID
  46             s = service ID
  47             w = CW
  48             y = payload
  49
  50           use a value as prefix to hide variable with this value, control characters will be escaped by "\"
  51
  52            example: ecmfmt = c&0p/i/d/s/l:h.e_w
  53                     (hide provider ID if 0)
  54
  55        loghistorylines = lines
  56           size of log message history in web interface or monitor, 0 = disabled, default:256
  57
  58        maxlogsize = kbytes
  59           maximum log file size, 0 = unlimited, default:10
  60
  61        logduplicatelines = 0|1
  62           1 = enable logging of duplicate lines in the log, default:0
  63
  64        disablelog = 0|1
  65           1 = disable log file, default:0
  66
  67        cwlogdir = path
  68           directory for CW logging, default:config dir
  69
  70        emmlogdir = path
  71           directory for EMM logging, default:config dir
  72
  73        usrfile = filename
  74           log file for user logging, default:none
  75
  76           log file format:
  77
  78            date
  79            time
  80            CWs per second
  81            username
  82            IP address of client
  83            TCP/IP port
  84            CWs found
  85            CWs from cache
  86            CWs not found
  87            CWs ignored
  88            CWs timed out
  89            CWs tunneled
  90            login time in unix/POSIX format
  91            logout time in unix/POSIX format
  92            protocol
  93
  94        disableuserfile = 0|1
  95           1 = avoid logging although userfile is set, default:1 (also set automatically if userfile is empty)
  96
  97        usrfileflag = 0|1
  98           usrfile logging mode:
  99
 100             0 = only client logon/logoff will be logged in usrfile (default)
 101             1 = each zapping of a client will be logged in usrfile
 102
 103        disablemail = 0|1
 104           1 = disable saving NDS Videoguard mail messages from provider, default:1
 105
 106        mailfile = file
 107           define file saving NDS Videoguard mail messages from provider, default:none
 108
 109        enableled = 0|1|2
 110            0 = LED support disabled (default)
 111            1 = LED support enabled for routers
 112            2 = LED support enabled for Qbox HD
 113
 114        waitforcards = 0|1
 115           1 = wait for local SCs on startup before opening network ports, default:1
 116
 117        waitforcards_extra_delay = delay
 118           additional delay in milli-seconds after waiting for local SCs on startup before opening network ports, default:500
 119
 120        preferlocalcards = 0|1
 121           SC decoding behavior:
 122
 123            0 = local SCs used like a remote reader
 124            1 = prefer cache exchange based SCs (default)
 125            2 = prefer local SCs
 126
 127        readerrestartseconds = seconds
 128           seconds beetween restarts, 0 = disable reader restart, default:5
 129
 130        block_same_ip = 0|1
 131           1 = reject looping ECMs from clients to readers with the same IP address, default:1
 132
 133        block_same_name = 0|1
 134           1 = reject looping ECMs from clients to readers with the same name, default:1
 135
 136        clienttimeout = milli-seconds|seconds
 137           value (clienttimeout in seconds < 100, else milli-seconds) for client process to wait for key, default:5
 138
 139        clientmaxidle = seconds
 140           value for client process being idle before disconnect, 0 = idle disconnect disabled, default:120
 141
 142        suppresscmd08 = 0|1
 143           0  =  tell  camd 3.5x, 3.57x and 3.78x clients not to request again for rejected CAID, service ID and provider ID combination, 1 = disable, can be
 144           overwritten per user in oscam.user, default:0
 145
 146        fallbacktimeout = milli-seconds
 147           time falling back to fallback reader, default:2500
 148
 149        fallbacktimeout_percaid = milli-seconds
 150           time falling back to CAID restricted fallback reader, default:2500
 151
 152        sleep = minutes
 153           time waiting for inactive users, default:none, can be overwritten per user in oscam.user
 154
 155        serverip = IP address
 156           bind service to specified IP address, default:none
 157
 158        bindwait = seconds
 159           value to wait for bind request to complete, default:120
 160
 161        netprio = 0|1|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16|17|18|19|20
 162           value for network priority:
 163           IPP value will be applied to SO_PRIORITY (system internal prioritization)
 164           DSCP value will be applied to IP_TOS/IPV6_TCLASS (the TOS field in the IP packet header)
 165
 166             0 = IPP=0; DSCP=CS0 (default)
 167             1 = IPP=1; DSCP=CS1
 168             2 = IPP=1; DSCP=AF11
 169             3 = IPP=1; DSCP=AF12
 170             4 = IPP=1; DSCP=AF13
 171             5 = IPP=2; DSCP=CS2
 172             6 = IPP=2; DSCP=AF21
 173             7 = IPP=2; DSCP=AF22
 174             8 = IPP=2; DSCP=AF23
 175             9 = IPP=3; DSCP=CS3
 176            10 = IPP=3; DSCP=AF31
 177            11 = IPP=3; DSCP=AF32
 178            12 = IPP=3; DSCP=AF33
 179            13 = IPP=4; DSCP=CS4
 180            14 = IPP=4; DSCP=AF41
 181            15 = IPP=4; DSCP=AF42
 182            16 = IPP=4; DSCP=AF43
 183            17 = IPP=5; DSCP=CS5
 184            18 = IPP=5; DSCP=EF
 185            19 = IPP=6; DSCP=CS6
 186            20 = IPP=7; DSCP=CS7
 187
 188        resolvegethostbyname = 0|1
 189           set mode for DNS resolving:
 190
 191             0 = getadressinfo (default)
 192             1 = gethostbyname
 193
 194        failbancount = count
 195           number of incorrect logins after an ip address will be blocked, default:0
 196
 197        failbantime = minutes
 198           time for IP based blocking for clients with an invalid login attempt, 0 = failban is disabled, default:0
 199
 200        dropdups = 0|1
 201           mode for duplicate client connections (requirement: uniq > 0):
 202
 203             0 = mark client as duplicate, but don't disconnect them (default)
 204             1 = drop duplicate connections instead of marking as duplicate
 205
 206        unlockparental = 0|1
 207           1 = unlock parental mode option to disable Seca and Viaccess pin code request for adult movie, default:0
 208
 209        double_check = 0|1
 210           1 = ECM will be send to two or more readers with the same SC and the CWs will be verified against each other, lb_nbest_readers must be set to 2 or
 211           higher, default:0
 212
 213        double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...
 214           ECM  will  be  send to two or more readers with the same SC and the CWs will be verified against each other for defined CAID or first two bytes of
 215           CAID, lb_nbest_readers must be set to 2 or higher, default:none
 216        getblockemmauprovid = 0|1
 217           1 = server overrides EMM blocking defined on client site, default:0
 218
 219        lb_mode = mode
 220           load balancing mode:
 221
 222            0 = load balance disabled, ECMs go to all readers (default)
 223            1 = fastest reader first, after 5 ECMs the reader with the fastest
 224                response time will be selected
 225            2 = oldest reader first, reader with the longest no answer
 226            3 = lowest usage level, the usage level will be calculated by the
 227                sum of 5 ECMS response times, the higher a reader is busy, the
 228                higher is usage level
 229
 230        lb_save = 0|counts
 231           save auto load balance statistics:
 232
 233                 0 = saving of auto load balance statistics disabled (default)
 234            counts = save auto load balance statistics every counts ECMs
 235                     (minimum 100)
 236
 237           To save CPU power a minimum counts of 100 is recommended.
 238
 239        lb_nbest_readers = counts
 240           set count of best readers for load balancing, default:1
 241
 242        lb_nfb_readers = counts
 243           set count of fallback readers for load balancing, default:1
 244
 245        lb_nbest_percaid = CAID1:count1[,CAID2:count2]...
 246           set count of best readers per CAIDs for load balancing, wildcard CAIDs with two-digit CAIDs possible, default:none
 247
 248            example: lb_nbest_percaid = 0100:4,0200:3,03:2,04:1
 249                     (wildcard CAIDs 03xx and 04xx)
 250
 251        lb_min_ecmcount = counts
 252           minimal ECM count to evaluate load balancing values, default:5
 253
 254        lb_max_ecmcount = counts
 255           maximum ECM count before resetting load balancing values, default:500
 256
 257        lb_reopen_seconds = seconds
 258           time between retrying failed load balanced readers/CAIDs/providers/services, default:900
 259
 260        lb_reopen_invalid = 0|fB1
 261           0 = E_INVALID will be blocked until statistics has been cleaned, default:1
 262
 263        lb_force_reopen_always = 0|1
 264           1 = force reopening immediately all failing readers if no matching reader was found, default:0
 265
 266        lb_retrylimit = milli-seconds
 267           retry next load balanced reader only if response time is higher then lb_retrylimit, default:0
 268
 269        lb_savepath = filename
 270           filenanme for saving load balancing statistics, default:/tmp/.oscam/stat
 271
 272        lb_stat_cleanup = hour
 273           hours after the load balancing statistics will be deleted, default:336
 274
 275        lb_retrylimits = CAID1:time1[,CAID2:time2]...
 276           load balancing retry limit time per CAID, wildcard CAIDs with two-digit CAIDs possible, default:none
 277
 278            example: lb_retrylimits = 12:0100,34:0200,5678:0300
 279                     (wildcard CAIDs 12xx and 34xx)
 280
 281        lb_noproviderforcaid = CAID1[,CAID2]...
 282           ignore provider information for CAIDs to reduce load balancing statistic data, wildcard CAIDs with two-digit CAIDs possible, default:none
 283
 284            example: lb_noproviderforcaid = 0100,02,0300,04
 285                     (wildcard CAIDs 02xx and 04xx)
 286
 287        lb_max_readers = limit
 288           restrict the reader count to limit during load balancing learning:
 289
 290                0 = unlimited (default)
 291            limit = restrict load balancer readers to limit
 292
 293        lb_auto_timeout = 0|1
 294           1 = enable automatic timeout based on load balancing statistics, default:0
 295
 296        lb_auto_timeout_p = percent
 297           percent added to average time as timeout time, default:30
 298
 299        lb_auto_timeout_t = milli seconds
 300           minimal time added to average time as timeout time, default:300
 301
 302        lb_auto_betatunnel = 0|1
 303           1 = enable automatic Betacrypt tunneling detection for CAIDs 1801, 1833, 1834, and 1835 for load balancing, Betacrypt defintion in oscam.user with
 304           betatunnel will be prefered, default:1
 305
 306        lb_auto_betatunnel_mode = 0|1|2
 307           set mode for automatic Betacrypt tunneling:
 308
 309            0 = CAID 18XX tunneling to CAID 17X2 only (default)
 310            1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
 311            2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
 312            3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
 313            4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
 314            5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
 315            6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)
 316
 317        lb_auto_betatunnel_prefer_beta = direction
 318           set direction for automatic Betacrypt/Nagravision selection:
 319
 320              0 = disabled (default)
 321              1 = always Betacrypt
 322            105 = represents the middle
 323            200 = always Nagravision
 324
 325    The [monitor] section
 326        port = 0|port
 327           UDP port for monitor, 0 = monitor disabled, default:0
 328
 329        serverip = IP address
 330           bind service to specified IP address, default:all
 331
 332        nocrypt = IP address|IP address range[,IP address|IP address range]...
 333           unsecured monitor connection, default:none
 334
 335            example: nocrypt = 127.0.0.1,192.168.0.0-192.168.255.255
 336
 337        aulow = minutes
 338           time no EMM occurs so that client is set to low, switch from status "active" to "on", default:30
 339
 340        monlevel = 0|1|2|3|4
 341           monitor level:
 342
 343            0 = no access to monitor
 344            1 = only server and own procs
 345            2 = all procs, but viewing only (default)
 346            3 = all procs, reload of oscam.user possible
 347            4 = complete access
 348
 349           monlevel can be overwritten per user in oscam.user.
 350
 351        hideclient_to = seconds
 352           time to hide clients in the monitor if not sending requests, 0 = disabled, default:25
 353
 354    The [webif] section
 355        httpport = [+]port
 356           port for web interface, 0 = disabled, praefix + = enable SSL, default:none, required
 357
 358        httpcert = file
 359           file for http SSL certificate, default:oscam.pem
 360
 361        httpforcesslv3  = 0|1
 362           1 = force using SSLv3, default:0
 363
 364        httpuser = username
 365           username for password protection, default:none
 366
 367        httppwd = password
 368           password for password protection, default:none
 369
 370        httpcss = path
 371           path for external CSS file, default:none
 372
 373        http_prepend_embedded_css = 0|1
 374           1 = embedded CSS will be added before external CSS , default:0
 375
 376        httptpl = path
 377           path  for  external  templates and picons, multiple simultaneously templates and picons are possible by creating sub folders (maximum length of 32
 378           alphanumeric characters), sub folders naming is corresponding to sub folder in URL, default:none
 379
 380            example: httptpl = /this/is/my/path
 381
 382                     folder with multiple templates:
 383                       /this/is/my/path/template1
 384                       /this/is/my/path/template2
 385
 386                     valid URLs:
 387                      http://host:port/template1
 388                      http://host:port/template2
 389
 390        httpjscript = path
 391           path for oscam.js javascript, default:none
 392
 393        httprefresh = seconds
 394           status refresh in seconds, default:none
 395
 396        httphideidleclients = 0|1
 397           1 = enables hiding clients after idle time set in parameter hideclient_to, default:0
 398
 399        httphidetype = type[type]...
 400           characters defining columns to hide in web interface status page (see type column), default:none
 401
 402            types:
 403
 404            'c': client
 405            'h': http
 406            'm': monitor
 407            'p': proxy
 408            'r': reader
 409            's': server
 410            'x': cache exchange
 411
 412        httpscript = path
 413           path to an executable script which you wish to start from web interface, default:none
 414
 415        httpallowed = IP address|IP address range[,IP address|IP address range]...
 416           http web interface connections allowed, default:127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1
 417
 418            example: httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255
 419
 420        httpdyndns = hostname[,hostname][,hostname]
 421           http web interface connections allowed, default:none
 422
 423            example: httpdyndns = host.example.com
 424                     httpdyndns = host1.example.com,host2.example.com
 425
 426        httpsavefullcfg = 0|1
 427           write config:
 428
 429            0 = all not empty parameters, all not default parameters, all
 430                parameters not containing the same value as the same
 431                parameter in global configuration (default)
 432            1 = all parameters
 433
 434        httpoverwritebakfile = 0|1
 435           1 = overwrite backup configuration files, default:0
 436
 437        httpreadonly = 0|1
 438           1 = read only modus for web interface, default:0
 439
 440        httpshowpicons = 0|1
 441           1 = show picons in user list, default:0
 442
 443        httppiconpath = path
 444           path to picons, default:none
 445
 446        httphelplang = en|de|fr|<available wiki languages>
 447           set right language for wiki entry point, default:en
 448
 449        httplocale = environment
 450           set the locale environment, default:none
 451
 452    The [lcd] section
 453        httposcamlabel = text
 454           set individual label in web interface header, default:OSCam
 455
 456        enablelcd = 0|1
 457           1 =enable LCD output, default:0
 458
 459        lcd_outputpath = path
 460           path for LCD output, default:/tmp
 461
 462        lcd_hideidle = 0|1
 463           1 = hide reader in LCD output if reader idle > 20 seconds, default:0
 464
 465        lcd_writeintervall = seconds
 466           LCD refresh interval (minimum 5), default:10
 467
 468    The [cache] section
 469        delay = milli-seconds
 470           value to delay cached requests, default:0
 471
 472        max_time = seconds
 473           maximum time CWs resist in cache, the time must be 2 seconds highter than the parameter clienttimeout, default:15
 474
 475        max_hit_time = seconds
 476           maximum time for cache exchange hits resist in cache for evaluating wait_time, default:15
 477
 478        wait_time = [caid][&mask][@provid][$servid][:awtime][:]dwtime[,[caid][&mask][@provid][$servid][:awtime][:]dwtime]...
 479           wait time in milli-seconds for cache exchange and Cardservproxy before sending ECMs to reader or proxy, default:none
 480
 481            example: wait_time = 0:50:250,0200@00009X:50:150,15:950,0500@000001:150,1602&ffdf:1200
 482
 483        cacheexenablestats = 0|1
 484           1 = enable statistics for cache exchange mode, default:0
 485
 486           Please consider memory consumption.
 487
 488        cacheex_cw_check = [caid][&mask][@provid][$servid]:mode:counter[,[caid][&mask][@provid][$servid]:mode:counter]...
 489
 490            mode = specify behaviour for counter:
 491
 492                   0 = when wait_time expires, serve highest counter's CW
 493                       got anyway, even if no counter reached (default)
 494                   1 = never serve CW from cache exchange stored in cache,
 495                       if it's counter not reaches counter. When wait_time
 496                       expires, requests will go to normal readers
 497
 498            counter = set minimum CW counter to allow CW is used, default:1
 499
 500        cacheex_mode1_delay = CAID1:time,[BCAID2:time]...
 501           delay in milli-seconds for asking cache exchange mode 1 readers, default:none
 502
 503        csp_port = port
 504           UDP port of Cardservproxy for cache exchange, default:none
 505
 506        csp_serverip = IP
 507           bind Cardservproxy for cache exchange to specified IP address, default:none
 508
 509        csp_ecm_filter = [caid][&mask][@provid][$servid][,[caid][&mask][@provid][$servid]]...
 510           Cardservproxy incoming ECM filter setting, default:none
 511
 512        csp_allow_request = 0|1
 513           allow incoming ECM request from Cardservproxy, default:1
 514
 515        csp_allow_reforward = 0|1
 516           1 = reforward other cacheex updates to Cardservproxy peers, option could cause loops, default:0
 517
 518        cwcycle_check_enable = 0|1
 519           1 = enable CW cycle check, default:0
 520
 521        cwcycle_check_caid = CAID[,CAID]...
 522           CAID enabled for CW cycle check, default:none
 523
 524        cwcycle_maxlist = count
 525           maximum CW cycle list entries, default:500, maximum:4000
 526
 527        cwcycle_keeptime = minutes
 528           minimum time a learned cycle time resists in memory, default:15, maximum:15
 529
 530        cwcycle_onbad = 0|1
 531           0 = log bad CW cycle only, 1 = drop bad CW cycle, default:1
 532
 533        cwcycle_dropold = 0|1
 534           1= drop old CW cycle, default:1
 535
 536        cwcycle_sensitive = 0|2|3|4
 537           drop CW mode:
 538
 539            0 = disabled
 540            2 = 2 (or more) same bytes and drop new CW
 541            3 = 3 (or more) same bytes and drop new CW
 542            4 = 4 (or more) same bytes and drop new CW (default)
 543
 544        cwcycle_allowbadfromffb = 0|1
 545           1 = allow bad cycles from a fixed fallback reader, default:0
 546
 547        cwcycle_usecwcfromce = 0|1
 548           1 = use CW info from cache exchange, default:0
 549
 550        wait_until_ctimeout = 0|1
 551           answer when cache exchange timeout expires, if no normal readers are available for sending ECMs:
 552
 553            0 = immediately send 'not found' to client (default)
 554            1 = wait for cache exchange answer until client timeout expires
 555
 556    The [camd33] section
 557        port = 0|port
 558           TCP port for camd 3.3x clients, 0 = disabled, default:0
 559
 560        serverip = IP address
 561           bind service to specified IP address, default:all
 562
 563        nocrypt = IP address|IP address range[,IP address|IP address range]...
 564           unsecured camd 3.3x client connection, default:none
 565
 566            example: nocrypt = 127.0.0.1,192.168.0.0-192.168.255.255
 567
 568        passive = 0|1
 569           1 = force passive camd 3.3x client, default:0
 570
 571        key = 128 bit key
 572           key for camd 3.3x client encryption, default:none
 573
 574            example: key = 01020304050607080910111213141516
 575
 576    The [cs357x] section
 577        port = 0|port
 578           UDP port for camd 3.57x clients, 0 = disabled, default:0
 579
 580        serverip = IP address
 581           bind service to specified IP address, default:all
 582
 583        suppresscmd08 = 0|1
 584           0 = tell camd 3.5x / 3.57x clients not to request again for rejected CAID, service ID and provider ID combination, 1 = disable, can be overwritten
 585           per user in oscam.user, default:0
 586
 587    The [cs378x] section
 588        port = 0|port[@CAID][:provid][,provid]...[;port@CAID[:provid][,provid]...]...
 589           TCP port/CAID/provid definitions for camd 3.78x clients, 0 = disabled, default:0
 590
 591            examples: port = 10000@0100:100000;20000@0200:200000,300000,400000
 592                      port = 30000
 593
 594        serverip = IP address
 595           bind service to specified IP address, default:all
 596
 597        keepalive = 0|1
 598           0 = disable camd 3.78x keepalive modus, default:0
 599
 600        suppresscmd08 = 0|1
 601           0  =  tell  camd 3.78x clients not to request again for rejected CAID, service ID and provider ID combination, 1 = disable, can be overwritten per
 602           user in oscam.user, default:0
 603
 604    The [newcamd] section
 605        key = DES key
 606           default key for newcamd client encryption, default:none
 607
 608            example: key = 0102030405060708091011121314
 609
 610        port = port[{DES key}]@CAID[:provid][,provid]...[;port[{DES key}]@CAID[:provid][,provid]...]...
 611           TCP port/DES key/CAID/provid definitions, default:none
 612
 613            example: port = 10000@0100:100000;20000{0102030405060708091011121314}@0200:200000,300000
 614
 615           Each CAID requires a separate port. If you don't specify a DES key for a port, the default DES key will be used.
 616
 617        serverip = IP address
 618           bind newcamd service to specified IP address, default:all
 619
 620        allowed = IP address|IP address range[,IP address|IP address range]...
 621           newcamd client connections allowed from, default:none
 622
 623            example: allowed = 127.0.0.1,192.168.0.0-192.168.255.255,::1
 624
 625        keepalive = 0|1
 626           0 = disable newcamd keepalive modus, default:0
 627
 628        mgclient = 0|1
 629           1 = provide share information of all available CAIDs and provider IDs to mgcamd clients, default:0
 630
 631    The [radegast] section
 632        port = 0|port
 633           TCP/IP port for radegast clients, 0 = disabled, default:0
 634
 635        serverip = IP address
 636           bind service to specified IP address, default:all
 637
 638        allowed = IP address|IP address range[,IP address|IP address range]...
 639           client connections allowed from, default:none
 640
 641            example: allowed = 127.0.0.1,192.168.0.0-192.168.255.255
 642
 643        user = username
 644           user name for radegast client
 645
 646    The [serial] section
 647        device = <user>@<device>[:baud][?option1=value1[&option2=value2]...]
 648                 [;<user>@<device>[:baud][?option1=value1[&option2=value2]...]]...
 649
 650           parameters:
 651            user   = account
 652            device = serial device name|hostname|IP,port
 653            baud   = serial port speed (for serial devices only)
 654            option = timeout = milli-seconds, timeout for connection,
 655                               default:50
 656                     delay   = milli-seconds, additional delay between two
 657                               characters, default:0
 658
 659           supported serial devices (autodection):
 660            HSIC    (humax sharing interface client)
 661            SSSP    (simple serial sharing protocol)
 662            bomba   (BOMBA firmware)
 663            dsr9500 (DSR 9500)
 664
 665            example: user1@/dev/ttyS1:115200?delay=1&timeout=5000
 666                     user2@192.160.0.1,12345?delay=1&timeout=5000
 667
 668    The [cccam] section
 669        port = 0|port[,0|port]...
 670           TCP/IP ports for CCcam clients, 0 = disabled, default:0
 671
 672        version = <main version>.<version>.<sub version>
 673           define CCcam version, minimum CCcam version 2.0.11, used with original CCcam only, default:none
 674
 675            example: version = 1.2.34
 676
 677        reshare = level
 678           reshare level for CCcam clients (default:10):
 679
 680           -1 = no resharing
 681            0 = resharing for direct peer only
 682            1 = resharing for direct peer and next level
 683            x = resharing for direct peer and next x level
 684
 685        reshare_mode = mode
 686           CCcam reshare mode:
 687
 688            0 = reader reshares only received SCs for CCcam readers,
 689                defined filters/CAIDs/provids on other readers
 690            1 = reader reshares received SCs (like=0) and defined services
 691            2 = reader reshares only defined reader services as virtual SCs
 692            3 = reader reshares only defined user services as virtual SCs
 693            4 = reader reshares only received SCs (default)
 694
 695           Every server is shared as hop = 0 and with defined reshare values.
 696
 697           Service reshare only works if positive services defined: no service - no reshare!
 698
 699        ignorereshare = 0|1
 700           CCcam reshare setting:
 701
 702            0 = use reshare setting of server (default)
 703            1 = use reshare setting of reader or user
 704
 705        stealth = 0|1
 706           1 = behaviour like the original CCcam: no activate partner detection and extended OSCam-CCcam protocol, prevent other OSCam to detect  the  server
 707           as OSCam server, default:0
 708
 709        minimizecards = mode
 710           mode how to provide CCcam servers to CCcam clients:
 711
 712            0 = no aggregation, remove duplicates only (default)
 713            1 = based on minimum hop: two SCs with different hops are
 714                summarized, new SCs get a smaller hop
 715            2 = aggregation based on CAIDs: all SCs with the same CAIDs
 716                will be merged, provider (maximum 32) will be merged, too
 717
 718        updateinterval = seconds
 719           interval to provide share list update to CCcam clients, values <= 10 are invalid and will be set to 30, default:240
 720
 721        keepconnected = 0|1
 722           set CCcam keepalive modus:
 723
 724             0 = disconnect client when maximum idle time is reached
 725             1 = keep client connected (default)
 726
 727        recv_timeout = milli-seconds
 728           set network timeout for receiving data, default:2000
 729
 730        forward_origin_card = 0|1
 731           1 = forward ECM request to reader holding this card, load balancer, fallback and caching will be disabled, default:0
 732
 733        nodeid = ID
 734           set CCcam node ID in hex, default:none
 735
 736            example: nodeid = 0a0b0c0d0e0f1011
 737
 738    The [gbox] section
 739        hostname = hostname| IP address
 740           set hostname or IP address for gbox protocol, default:none
 741
 742        port = port[,port]...
 743           UDP port for gbox server, default:0
 744
 745        my_password = password
 746           password for connection to local gbox peer, default:none
 747
 748        proxy_card = <CAID><provid>[,<CAID><provid>]...
 749           proxy reader SCs to be reshared into gbox network, default:none
 750
 751        ccc_reshare = 0|1
 752           1 = enable CCCam reshare, default:0
 753
 754        my_vers = version
 755           set gbox version in hexadecimal low byte, default:2A
 756
 757        my_cpu_api = byte
 758           set gbox CPU and API byte in hexadecimal, default:40
 759
 760        gbox_reconnect = time
 761           send message to peers in seconds, default:180, min:60, max:300
 762
 763        log_hello = 0|1
 764           1 = log hello messages ,default:1
 765
 766        dis_attack_txt = 0|1
 767           1 = disable creation of file attack.txt ,default:0
 768
 769        gsms_disable = 0|1
 770           1 = disable gbox short message service (GSMS),default:1
 771
 772           sending  a  messeage:  /tmp/gsms.txt:  <box  ID>  <1=mormal  message|2=OSD/TV  message>  <message  6  to 127 characters>, status will be stored in
 773           '/tmp/gsms.ack' respective 'gsms.nack', receiving a message: The message will be stored in /tmp/gsms.log
 774
 775        tmp_dir = path
 776           temporary directory for gbox, default:/tmp/.oscam
 777
 778        accept_remm_peer = peer-id1[,peer-id2]...
 779      accept REMM requests from gbox peer(s), default:none
 780
 781    The [scam] section
 782        port = port
 783           UDP port for scam server, default:0
 784
 785    The [dvbapi] section
 786        enabled = 0|1
 787           1 = DVB API enabled, default:0
 788
 789           Create file /tmp/.pauseoscam to pause DVB API, e.g. if STB goes into standby and OSCam remains as SC server only.
 790
 791        listen_port = 0|port
 792           TCP/IP port for SAT IP clients, filtering has to be done on client site, 0 = disabled, default:0
 793
 794        user = username
 795           user name for DVB API client, default:anonymous
 796
 797        ignore = <CAID>[,<CAID>]... (detached by oscam.dvbapi, obsolete)
 798           CAIDs to be ignored, default:none
 799
 800        services = <service ID>[,<service ID>]... (detached by oscam.dvbapi, obsolete)
 801           services to be prioritized, default:none
 802
 803        priority = <CAID>:<provider ID>[,CAID:<provider ID>]... (detached by oscam.dvbapi, obsolete)
 804           CAIDs and provider IDs to be prioritized, default:CAIDs and provider IDs of local SCs will be prioritized
 805
 806        au = 0|1
 807           AU mode:
 808
 809            0 = disable AU (default)
 810            1 = enable AU
 811
 812        pmt_mode = 0|1|2|3|4|5
 813           PMT mode:
 814
 815            0 = use camd.socket and PMT file, default
 816            1 = disable reading PMT file
 817            2 = disable camd.socket
 818            3 = read PMT file on startup only
 819            4 = do not use signal handler for monitoring /tmp
 820            5 = do not use signal handler for monitoring /tmp,
 821                disable camd.socket
 822
 823            ecminfo_file = 0|1
 824           ecm.info types:
 825
 826            0 = Disable ecm.info file
 827            1 = Enable ecm.info file (default)
 828
 829        ecminfo_type = 0|1|2|3|4|5
 830           ecm.info types:
 831
 832            0 = OSCam syntax (default)
 833            1 = OSCam syntax with ECM time in ms instead of seconds
 834            2 = WiCardd
 835            3 = mgcamd
 836            4 = CCcam
 837            5 = camd3
 838
 839        request_mode = 0|1
 840           CAID request mode:
 841
 842            0 = try all possible CAIDs one by one (default)
 843            1 = try all CAIDs simultaneously
 844
 845        boxtype = dbox2|dreambox|dm7000|duckbox|ufs910|ipbox|ipbox-pmt|qboxhd|coolstream|neumo|samygo|pc
 846           set boxtype, auto detection of DVB API will be aspired, default:dreambox
 847
 848           ipbox with camd.socket support, currently only with PGI image version 0.6 or above, verified on HD models only
 849
 850           ipbox-pmt can be used on any DGS based images (with or without camd.socket support), verified on HD models only
 851
 852           pc is for generic pc support (currently supported on VDR with vdr-plugin-dvbapi)
 853
 854        read_sdt = 0|1|2
 855           mode of provider, channel name and service type auto detection via SDT:
 856
 857            0 = disabled (default)
 858            1 = enabled for non FTA channels only
 859            2 = enabled for all channels
 860
 861        write_sdt_prov = 0|1
 862           mode writing provider name into oscam.srvid2 file:
 863
 864            0 = disabled (default)
 865            1 = enabled
 866
 867        demuxer_fix = 0|1
 868           try fixing audio/video sync errors:
 869
 870            0 = disabled (default)
 871            1 = enabled
 872
 873        cw_delay = milli-seconds
 874           delay of CW writing, default:none
 875
 876        delayer = milli-seconds
 877           minimum time to write CW, default:0
 878
 879        reopenonzap =  0|1
 880           1 = reopen demux devices on each channel switching, default:0
 881
 882    The [anticasc] section
 883        enabled = 0|1
 884           1 = enable anti-cascading, default:0
 885
 886        numusers = quantity
 887           anti-cascading: user per account, 0 = anti-cascading disabled, default:0
 888
 889        sampletime = minutes
 890           duration of sample, default:2
 891
 892        samples = quantity
 893           quantity of samples over limit, default:10
 894
 895        penalty = 0|1|2|3
 896           level of penalty:
 897
 898            0 = only logging (default)
 899            1 = send fake CWs
 900            2 = temporary user ban
 901            3 = send delayed CWs
 902
 903           penalty can be overwritten per user in oscam.user.
 904
 905        aclogfile = filename
 906           file for anti-cascading logging, default:none
 907
 908        fakedelay = milli-seconds
 909           fake delay time, default:1000, minimum value is 100, maximum value is 3000
 910
 911        denysamples = quantity
 912           how many samples should be penalized, default:8
 913
 914        acosc_enabled = 0|1
 915           1 = enable anti-cascading over SID count, default:0
 916
 917        acosc_max_ecms_per_minute = count
 918           maximum ecms per minute, 0 = unlimited, default:0
 919
 920        acosc_max_active_sids = count
 921           maximum active SIDs with anti-cascading over SID, 0 = unlimited, default:0
 922
 923           Can be overwritten per user in oscam.user.
 924
 925        acosc_zap_limit = count
 926           zap limit for anti-cascading over SID, 0 = unlimited, default:0
 927
 928           Can be overwritten per user in oscam.user.
 929
 930        acosc_penalty = 0|1|2|3|4
 931           level of penalty with anti-cascading over SID count:
 932
 933            0 = only logging (default)
 934            1 = send fake CWs
 935            2 = temporary user ban
 936            3 = send delayed CWs
 937            4 = temporary hidecards to the client
 938
 939           Can be overwritten per user in oscam.user.
 940
 941        acosc_penalty_duration = seconds
 942           penalty duration for anti-cascading over SID count, default:0
 943
 944           Can be overwritten per user in oscam.user.
 945
 946        acosc_delay = milli-seconds
 947           delay for anti-cascading over SID count, default:0
 948
 949           Can be overwritten per user in oscam.user.
 950
 951 LOGGING
 952        ·  reader stages
 953
 954            1 = cacheex (=1) reader (C)
 955            2 = local SCs (L)
 956            3 = other reader / proxies (P)
 957            4 = fallback reader (F)
 958
 959        ·  logging format
 960
 961            stage/used/chosen/possible
 962
 963 MONITOR
 964        monitor commands:
 965
 966        ·  login <user> <password>
 967
 968           login (for unencrypted connections only)
 969
 970
 971        ·  getuser <user> <parameter>=<value>
 972
 973           get parameter for user
 974
 975
 976        ·  setuser <user> <parameter>=<value>
 977
 978           set parameter for user
 979
 980
 981        ·  setserver <parameter>=<value>
 982
 983           set parameter for server
 984
 985
 986        ·  exit
 987
 988           exit monitor
 989
 990
 991        ·  log <on|onwohist|off>
 992
 993           enable|enable without hitory|disable logging for 2 minutes
 994
 995
 996        ·  status
 997
 998           list of current processes and clients
 999
1000
1001        ·  shutdown
1002
1003           shutdown OSCam
1004
1005
1006        ·  restart
1007
1008           restart OSCam
1009
1010
1011        ·  keepalive
1012
1013           send keepalive
1014
1015
1016        ·  reload
1017
1018           reinit user db, clients and anti-cascading, for newcamd connections: after reloading the provid, please restart newcamd client
1019
1020
1021        ·  details <PID>
1022
1023           details about selected PID
1024
1025
1026        ·  reread
1027
1028           read again
1029
1030
1031        ·  debug <level>
1032
1033           set debug level (monlevel > 3 required)
1034
1035           debug level mask:
1036                0 = no debugging (default)
1037                1 = detailed error messages
1038                2 = ATR parsing info, ECM dumps, CW dumps
1039                4 = traffic from/to the reader
1040                8 = traffic from/to the clients
1041               16 = traffic to the reader-device on IFD layer
1042               32 = traffic to the reader-device on I/O layer
1043               64 = EMM logging
1044              128 = DVB API logging
1045              256 = load balacing logging
1046              512 = cache exchange logging
1047             1024 = client ECM logging
1048            65535 = debug all
1049
1050        ·  version
1051
1052           show OSCam version
1053
1054
1055        ·  commands
1056
1057           show all valid monitor commands
1058
1059 WEB INTERFACE
1060        ·  template system
1061
1062           The web interface allows you to create your own template. For developing your own template request the orignal template with the  non-linked  page
1063           savetemplates.html. Store your own template in the directory specified by httptpl.
1064
1065 CACHING
1066        types of ECM caching:
1067
1068        ·  cache1
1069
1070           ECM and CW in cache already.
1071
1072        ·  cache2
1073
1074           ECM and checksum in cache already.
1075
1076 SEE ALSO
1077        list_smargo(1), oscam(1), oscam.ac(5), oscam.cacheex(5), oscam.cert(5), oscam.dvbapi(5), oscam.fakecws(5), oscam.guess(5), oscam.ird(5),
1078        oscam.provid(5), oscam.ratelimit(5), oscam.server(5), oscam.services(5), oscam.srvid(5), oscam.srvid2(5), oscam.tiers(5), oscam.user(5),
1079        oscam.whitelist(5)
1080
1081
1082
1083                                                                                                                                                oscam.conf(5)