OSCam/en/Config/oscam.conf

2012-05-01T09:35:51Z

Claudius: /* disablemail */ typo fix

[[Kategorie:OSCam]]
{{OSCamHomeLinks}}

==oscam.conf==

=== The [global] section ===

The main configuration file for OSCam contains global parameters such as debugging, logging, monitor, protocols and anti-cascading. Sections in oscam.conf are nonrecurring. The [global] section is required. All other sections are optional.

{{OSCamConfGlobalParameter}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If a parameter is empty or is not listed in config-file, then apply the default values !

==== nice ====
{{Optional/en}}

'''Systempriority'''

OSCam requires almost no CPU-power. But if CPU-power is required, it should be available immediatly. Values between 20 and -20 are possible. 20 = low, -20 = very high. If this parameter is commented out (#), this function is not called. Important for example for dbox2[http://de.wikipedia.org/wiki/DBOX2], if the error messages "''relocation error:setpriority''". See [http://de.wikipedia.org/wiki/Prioritätsscheduling Prioritätsscheduling]

Example:
nice = -1

Default:
nice = 99

==== Log ====
Format:
CAID&ProviderID/ECMPID/ServiceID/length:checksum

Debug-Level:
0 = no debugging (default)
2 = ATR parsing info, ECM dumps, CW dumps
4 = traffic from/to the reader
8 = traffic from/to the clients
16 = traffic to the reader-device on IFD layer
32 = traffic to the reader-device on I/O layer
64 = EMM logging
128 = DVBAPI logging
256 = load balancing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== logfile =====
{{optional/en}}

Logging target
logfile = [filename][;syslog][;stdout]

You can define a maximum of one filename (not more!) and additionally to log to stdout or syslog (you can also only log to stdout or syslog and omit the filename).

Opportunities:

logfile = /var/log/oscam.log # file or linux device (for example /dev/tty)
logfile = syslog # log to syslogd
logfile = stdout # showing the log on the console

Example:
logfile = /etc/oscam/logs/oscam.log;stdout

Default:
logfile = /var/log/oscam.log

Format logfile:
CAID&ident/provider/length:checksum

===== loghistorysize =====
{{optional/en}}

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== maxlogsize =====
{{required}}

Here the maximum size of logfiles are set in KBytes. This is especially important for server with only a small amount of memory (dbox2). Therefore it is strongly recomended to determine carefully that size at such servers. Not infrequently a system "bursting" because the logfile uncontrolled large scale adopted!

Example
maxlogsize = 20 # Logfile reaches to 20 KBytes
= 0 # Logfile '''unlimited'''

Default:
maxlogsize = 10 # Logfile reaches to 10 KBytes (default)

===== disablelog =====
{{optional/en}}

switches logfile '''off'''
1 = '''no log'''
0 = '''log'''

Example:
disablelog = 1 # '''no''' log

Default:
disablelog = 0 # '''log'''

===== cwlogdir =====
{{Optional/en}}

A path for cw logging can be configured here. The path is relative to the work directory and must exist. Otherwise no logs are created and no errors are reported.

CWs (control words) are the answers of the card which decrypts a certain channel for some seconds before the next cw is transmitted. The CW log file can be used for delayed decoding of this channel. This is also called offline decoding. Watch this [http://www.youtube.com/watch?v=-K--PEFYBng]

Oscam creates a new *.cwl file for each channel and each day. The file name contains the date, service ID and service name, e.g. 110808_I000B_Sky_Cinema_+1.cwl with this contents:

<syntaxhighlight lang="bash">
# OSCam cardserver v0.99.4 - http://streamboard.gmc.to:8001/oscam/wiki
# control word log file for use with tsdec offline decrypter
# DATE 2011-08-08, TIME 23:49:10, TZ CEST
# CAID 0x1702, SID 0x000B, SERVICE "Sky_Cinema_+1"
1 9E E3 BB 3C A4 C3 BE 25 # 23:49:10
0 D0 24 B3 A7 95 82 3B 52 # 23:49:17
1 A9 76 35 54 37 38 F3 62 # 23:49:23
0 55 70 87 4C 22 26 C4 0C # 23:49:30
1 F0 16 22 28 36 3A 03 73 # 23:49:38
0 5D 83 44 24 8F C7 5D B3 # 23:49:44
</syntaxhighlight>

All cws are logged if at least one user watches the channel. Please choose a path with enough space, since per day and channel some 10KB of data are created. A script that moves/deletes the log files regularly is recommended.

Example:
cwlogdir = /var/log/

Default:
cwlogdir = # [blank] no path for cw-log, logging disabled

===== emmlogdir =====
{{Optional/en}}

Setting a path for emm-log. You can define with the "saveemm-*"-Parameters in oscam.server which EMMs should be logged.

Example:
emmlogdir = /var/log/

Default:
emmlogdir = # [blank] the config folder will be used for emm logging

===== usrfile =====
{{Optional/en}}

Set a name für userfile

Format of the userfile:
date
time
CWs per second
username
IP address of client
TCP/IP port
CWs found
CWs from cache
CWs not found
CWs ignored
CWs timeout
CWs tunneled
login time in UNIX/POSIX format
logout time in UNIX/POSIX format
protocol

Example:
usrfile = userfile

Default:
usrfile = 0

===== disableuserfile =====
{{Optional/en}}

Now it is crazy: Even if a logfile is switched on (see logfile), the userfile can be turned off!

Example:
disableuserfile = 1 # '''no''' userfile
= 0 # '''userfile'''

Default:
disableuserfile = 0

===== usrfileflag =====
{{Optional/en}}

Setting the logging-modus
0 = Only login and logout will be logged
1 = Each zapping from client will be logged
Default is 0

Example:
usrfileflag = 1 # All will be logged

Default:
usrfileflag = 0 # Only login und logout will be logged

===== saveinithistory =====
{{Optional/en}}

Save SC init history to /tmp/.oscam/reader<number>. Needed to show entitlements.

Example:
saveinithistory = 1 # save to /tmp/.oscam/reader<number>

Default:
saveinithistory = 0 # no save

===== mailfile =====
{{Optional/en}}

mailfile = file

define file saving NDS Videogard mail messages from provider. Default: [blank] none

===== disablemail =====
{{Optional/en}}

disablemail = 0|1

disable saving NDS Videogard mail messages form provider. Default = 1 (disabled)

==== Reader ====

===== enableled =====
{{Optional/en}}

NEW svn6285:01/23/2012

enableled = 0|1|2

0 = LED support disabled (default)
1 = LED support enabled for routers
2 = LED support enabled for Qbox HD

===== serialreadertimeout =====
{{Optional/en}}

'''Only using Serialreader!'''

timeout for serial reader in milli-seconds

Example:
serialreadertimeout = 1200 # Timeout after 1200 milli-seconds

Default:
serialreadertimeout = 1500 # Timeout after 1500 milli-seconds

===== waitforcards =====
{{Optional/en}}

wait for local SCs on startup before opening network ports

Example:
waitforcards = 0 # don't wait

Default:
waitforcards = 1 # wait

===== waitforcards_extra_delay =====
{{Optional/en}}

waitforcards_extra_delay = milli seconds

additional delay in milli seconds after waiting for local SCs on startup before opening nework ports

default = 500

===== preferlocalcards =====
{{Optional/en}}

try decoding on local cards first

Example:
preferlocalcards = 1 # prefer local cards

Default:
preferlocalcards = 0 # don't prefer local cards

===== readerrestartseconds =====
{{Optional/en}}

waiting time in seconds beetween restarts

Example:
readerrestartseconds = 10 # waiting time 10 seconds
= 0 # '''no restarts!'''

Default:
readerrestartseconds = 5 # waiting time 5 seconds

==== Cache ====

===== cachedelay =====
{{optional/en}}

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
NEW svn6805:01/26/2012

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request

===== max_cache_count =====
{{Optional/en}}
NEW svn6805:01/26/2012

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
NEW svn:6111/12/22/2011

cacheexwaittime = delay

maximum wait time for a cache entry in milli seconds, default:50

===== cacheexenablestats =====
{{Optional/en}}
NEW svn:6161/12/22/2011

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

[[Datei:WarningS.png|text-bottom]] '''Warning:''' Please consider memory consumption!

==== Client ====

===== clienttimeout =====
{{Optional/en}}

value (clienttimeout in seconds < 100, else milli-seconds) for client process to wait for key

Beispiele:
clienttimeout = 10 # after 10 seconds timeout
clienttimeout = 10000 # also timeout after 10 seconds (see Tipp!)

Default:
clienttimeout = 5 # after 5 seconds timeout

[[Datei:WarningS.png|text-bottom]] '''Attention:''' At values of < 100 counts Cardserver in seconds, at values >= 100 Cardserver counts in milliseconds!

===== clientmaxidle =====
{{Optional/en}}

value for client process being idle before disconnect in seconds

Example:
clientmaxidle = 200 # Disconnect after 200 seconds
= 0 # idle disconnect disabled

Default:
clientmaxidle = 120 # Disconnect after 120 seconds

===== suppresscmd08 =====
{{Optional/en}}

suppresscmd08 = 0|1

0 = tell camd35[cs3.57x]-clients not to request again for rejected CAID, service ID and provider ID combination (default)
1 = disabled

Can be overwritten in oscam.user!

More here:: http://streamboard.gmc.to/wbb2/thread.php?threadid=27459&threadview=0&hilight=cmd08&hilightuser=0&page=1

==== fallbacktimeout ====
{{Depends/en}}

At several readers (see Chapter [reader] in oscam.server) one reader can be defined to them, for example in case of failure of the other readers, the traffic falls back.
Maximum waiting time of the [[Cardserver]]s in milliseconds for primary [[Reader]], before [[Fallback]]-Reader (if any!) are questioned.

Example:
fallbacktimeout = 1500

Default:
fallbacktimeout = 2500

[[Datei:WarningS.png|text-bottom]] '''Attention:''' The value must be greater than the value in "serialreadertimeout", otherwise the default is used.

==== sleep ====
{{Optional/en}}

time waiting for inactive users in minues, can be overwritten per user in oscam.user

Example:
sleep = 5 # waiting time 5 minutes

Default:
sleep = # [blank] no waiting time

==== serverip ====
{{optional/en}}

Bind service to specified IP-address

Example:
serverip = 192.168.178.1

Default:
serverip =

OSCam listen to all IP's

==== bindwait ====
{{Optional/en}}

value in seconds to wait for bind request to complete. If OSCam within this time can not bind, he finished with "Bind Request failed".

Causes may include:
* Double assignment of ports
* "crashed" OSCam has not released the ports again
* OSCam was started serveral times while

Example:
bindwait = 20 # waiting time 20 seconds

Default:
bindwait = 120 # waiting time 120 seconds

==== netprio ====
{{Optional/en}}

network priority

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

==== resolvegethostbyname ====
{{Optional/en}}

set mode for DNS resolving:
0 = getadressinfo (default)
1 = gethostbyname

Example:
resolvegethostbyname = 1 # gethostbyname

Default:
resolvegethostbyname = 0 # adressinfo system given

==== failbantime ====
{{Optional/en}}

time for IP based blocking for clients with an invalid login attempt in minutes

Beispiel:
failbantime = 5
# IP will be blocked for 5 minutes. New logins are denied.
# no clientthread will be created.

Default:
failbantime = 0 # failban off (default)

==== failbancount ====
{{Optional/en}}

Failbancount = Number of allowed failed attempts with incorrect data
= 0 (default) IP is now blocked on the first try with incorrect data!

If within '''failbantime''' more than in '''failbancount''' allowed trials to be registered, the IP for the remainder failbantime is locked. After a period of failbantime are again full failbancount available. Failbancount is thus a relaxation of rules!

==== dropdups ====
{{Optional/en}}

mode for duplicate client connections

0 = mark client as duplicate, but don't disconnect them (default)
1 = drop duplicate connections instead of marking as duplicate

==== unlockparental ====
{{Optional/en}}

'''Only Seca and Viaccess'''

unlock parental mode option to disable pin code request for adult movie.
In order to work properly, this option may required that you define the card PIN code in your card reader configuration.

Example:
unlockparental = 1 # parental lock mode disabled

Default:
unlockparental = 0 # parental lock mode enabled

==== double_check ====
{{Optional/en}}

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 higher

Example:
double_check = 1 # on

Default:
double_check = 0 # off

==== Loadbalancer ====

===== lb_mode =====
{{Optional/en}}

'''loadbalance mode'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If load balancing is activated here, it may in oscam.server among services and ident are '''no entries'''!

If there are 2 or more of the same SC, the load can be distributed evenly on the cards. For more see [[OSCam/en/Loadbalancing|Loadbalancing]]

Example:
lb_mode = 0 loadbalance disabled, ECMs go to all readers
lb_mode = 1 fastest reader first, after 5 ECMs the reader with the fastest response time will be selected
lb_mode = 2 oldest reader first, reader with the longest no answer
lb_mode = 3 lowest usage level, the usage level will be calculated by the sum of 5 ECMS response times, the higher a reader is busy, the higher is usage level

Default:
lb_mode = 0 # disabled

===== lb_save =====
{{Optional/en}}

Save autoloadbalance statistics (counts). To save CPU power a minimum counts of 100 is recommended.

Example:
lb_save = 100 # counts of ECM's after statistics are saved

Default:
lb_save = 0 # no svae

===== lb_nbest_readers =====
{{Optional/en}}

set count of best readers for loadbalancing.

Example:
lb_nbest_readers = 2 # requests always go to two reader

Default:
lb_nbest_readers = 1 # requests go to one reader

===== lb_nfb_readers =====
{{Optional/en}}

set count of fallback readers for loadbalancing

Example:
lb_nfb_readers = 2 # two fallbackreader

Default:
lb_nfb_readers = 1 # one fallbackreader

===== lb_reopen_mode =====
{{Optional/en}}

lb_reopen_mode = 0|1

loadbalancing reopen readers mode:
= 0 # standard late reopening of blocker readers (default)
= 1 # fast reopening of blocker readers

===== lb_nbest_percaid =====
{{Optional/en}}

CHANGE svn 5893:08/19/2011

Set count of best readers per CAIDs for loadbalancing, wildcard CAIDs with two-digit CAIDs possible

lb_nbest_percaid = # number
= [blank] # none (default)

example:
lb_nbest_percaid = 0100:4,0200:3,03:2,04:1
(wildcard CAIDs 03xx and 04xx)

===== lb_min_ecmcount =====
{{Optional/en}}

minimal ECM count to evaluate loadbalancing values

Example:
lb_min_ecmcount = 2 # 2 counts

Default:
lb_min_ecmcount = 5 # 5 counts

===== lb_max_ecmcount =====
{{Optional/en}}

Maximum ECM count before resetting loadbalancing values.

Example:
lb_max_ecmcount = 200 # 200 counts

Default:
lb_max_ecmcount = 500 # 500 counts

===== lb_reopen_seconds =====
{{Optional/en}}

time in seconds between retrying failed readers/CAIDs/providers/services

Example:
lb_reopen_seconds = 500 # retry after 500 seconds

Default:
lb_reopen_seconds = 900 # retry after 900 seconds

===== lb_retrylimit =====
{{Optional/en}}

Retry next readers '''only''' if response time is higher then lb_retrylimit in '''milli seconds'''.

Example:
lb_retrylimit = 500 # retry next reader only, if response time is higher than 500 ms

Default:
lb_retrylimit = 800

===== lb_savepath =====
{{Optional/en}}

Filenanme for saving loadbalancing statistics

default = /tmp/.oscam/stat

===== lb_stat_cleanup =====
{{Optional/en}}

hours after the loadbalancing statistics will be deleted

default = 336

===== lb_use_locking =====
{{Optional/en}}
OBSOLETE svn6166:12/28/2011

disable parallel and identical ECM requests

1 = on
0 = off # default:0
 
'''Schlocke:'''
* You should choose this option only if:
** slow system
** high load
** the same ECM requests come not from the cache, but will continue to the confirmed reader.

* Adventages, if activated:
** By synchronizing, an ECM request made by one. The identification of cache or request and assignment of the reader by loadbalancer is always successful.

* Disadventages, if activated:
** The synchronisation prevents multithreading and the probability of higher response times.

* Adventages, if NOT activated:
** Faster transit times for ECM requests

* Disadventages, if NOT activated:
** May have dual (n-fold) possible requests to the readers.
 

===== lb_retrylimits =====
{{Optional/en}}

CHANGE svn:5754:07/31/2011

lb_retrylimits = CAID1:time1[,Caid2:time2]...

loadbalancing retry limit time per CAID in milliseconds, wilcard CAIDs with 2-digit Caids possible

default = none

example:
lb_retrylimits = 12:0100,34:0200,5678:0300
(wildcard CAIDs 12xx and 34xx)

===== lb_noproviderforcaid =====
{{Optional/en}}

CHANGE svn 5758:08/01/2011

lb_noproviderforcaid = CAID1[,CAID2]...

ignore provider information CAIDs to reduce statistic date, wildcard CAIDs with two-digit CAIDs possible

example:
lb_noproviderpercaid = 12:0100,34:0200,5678:0300
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_max_readers =====
{{Optional/en}}

lb_max_readers = limit (number)

restrict the reader count to limit during learning

0 = unlimited (default)
x = restrict loadbalancer readers to limit x (number)

===== lb_auto_betatunnel =====
{{Optional/en}}

lb_auto_betatunnel = 0|1

enable automatic Betacrypt tunneling for CAIDs 1801, 1833, 1834 and 1835 in loadbalancing mode
lb_auto_betatunnel = 0 # disabled
= 1 # enabled (default)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Betacrypt definition in oscam.user with betatunnel will be prefered [http://streamboard.gmc.to/wiki/index.php/OSCam/en/Config/oscam.user#betatunnel]!

===== lb_auto_betatunnel_prefer_beta =====
{{Optional/en}}

NEW svn6045:11/27/2011

lb_auto_betatunnel_prefer_beta = time factor

set automatic Betacrypt tunneling time factor prefering Betacrypt over Nagravision in percent

default = 50

=== Monitor ===
'''Only if monitor is used!'''

{{OSCamConfMonitorParameter}}

==== port ====
{{Optional/en}}
UDP port for monitor
port = 0 # monitor disabled
= # port number

Beispiel:
port = 24480 # monitor on, port = 24480

==== serverip ====
{{Optional/en}}

bind service to specified IP address
serverip = # IP adress
= # [blank] all IP's (default)

==== nocrypt ====
{{Optional/en}}

unsecured monitor connection
[,IP address|IP address range]...

Possible
* one or more IP adresses
* one or more IP adress ranges
* mixture of IP adresses and IP adress ranges

Example
nocrypt = 127.0.0.1,192.168.0.0-192.168.255.255
= Host 127.0.0.1 and IP range 192.168.0.0 to 192.168.255.255

Default
nocrypt = # [blank] no secured monitor connection

==== aulow ====
{{Optional/en}}

time no EMM occurs so that client is set to low in minutes

Example
aulow = 30 # After 30 minutes whithout EMM client will be switches to "Low" (default).

==== monlevel ====
{{Optional/en}}

monitor-level
0 = no access to monitor
1 = only server and own procs
2 = all procs, but viewing only, default
3 = all procs, reload of oscam.user possible
4 = complete access

Example
monlevel = 4 # complete access

monlevel can be overwritten per user in oscam.user!

==== hideclient_to ====
{{Optional/en}}

Time to hide clients in the monitor if not sending requests. See also parameter '''httphideidleclienst''' in section [webif].
hideclient_to = 1 # hide clients
= 0 # no hide

==== appendchaninfo ====
{{Optional/en}}

Append channel name on log messages. Very useful when using [webif]!
appendchaninfo = 1 # append chanel name
= 0 # no append chanel name (default)

=== lcd ===
{{OSCamConfLCDParameter}}

==== enablelcd ====
{{Optional/en}}

NEW svn6285:01/23/2012

enablelcd = 0|1|2

0 = default
1 = enable LCD

==== lcd_outputpath ====
{{Optional/en}}

Path for LCD output

Default:
lcd_outputpath = [blank] /tmp

==== lcd_hideidle ====
{{Optional/en}}

hide reader in LCD output if reader idle > 20 seconds, default:0

==== lcd_writeinterval ====
{{Optional/en}}

LCD refresh interval (minimum 5), default:10

=== WebIf ===
'''Only if WebIf is used!'''

{{OScamConfWebIfParameter}}

==== httpport ====
{{required}}

port for web interface,
0 = disabled, praefix + = enable SSL

Example
httpport = 83 # Webinterface listening on '''http-port 83'''
= +83 # Webinterface listening on '''https-port 83''' (SSL)
0 # Webinterface disabled (default)

==== httpcert ====
{{Optional/en}}

file for http SSL certificate
httpcert = oscam.cert # (look there)
= # [blank] file oscam.pem (embedded) is used

==== httpforcesslv3 ====
{{Optional/en}}
NEW svn:6321/01/30/2012

httpforcesslv3 = 0|1

example
httpforcesslv3 = 0 none (default)
= 1 force using SSLV3

==== httpuser ====
{{Optional/en}}

Username for password protection. [blank] is default, of which is strongly discouraged!
httpuser = # xyxyxy (all characters and figures are allowed)

==== httppwd ====
{{Optional/en}}

Password for password protection. It is the same as for httpuser.
httppwd = # 123456

'''The ''user'' and ''pwd'' parameters are queried when connecting to the webinterface in a messagebox. If they are missing ore corrupted a message ''Forbidden'' appears and the connection is aborted!'''

==== httpcss ====
{{Optional/en}}

path for external CSS file

For webinterface different styles are available.

Example
httpcss = # /etc/oscam/harvest_round_Firefox.css
= # [blank] embedded style is used (default)

Styles you find here: http://streamboard.gmc.to/wbb2/thread.php?threadid=30083&hilight=style

==== httptpl ====
{{Optional/en}}

path for external templates
httptpl =
= # [blank] No external templates

==== httprefresh ====
{{Optional/en}}

status refresh in seconds

httprefresh = 7 # status will be refreshed after 7 seconds
= # [blank] no refreshing

==== httphideidleclients ====
{{Optional/en}}

Enables hiding clients after idle time set with parameter ''' hideclient_to''' in section [monitor].
httphideidleclients = 1 # hide
= 0 # hide not (default)

==== httpscript ====
{{Optional/en}}

Path to an executable script which you wish to start from web interface
httpscript = # path
= # [blank] no path

==== httpallowed ====
{{required}}

http web interface connections allowed. [blank] is allowed (default), but that makes no sense! If the webinterface to be used, then there must be a way to connect with him. Therefore we declare this parameter as '''mandatory'''!
IP address|IP address range[,IP address|IP address range]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed

==== httpdyndns ====
{{Optional/en}}
CHANGE svn6558:03/21/12

http web interface connections allowed

httpdyndns = hostname [,hostnahme][,hostname]

Example
httpdyndns = host1.example.com,host2.example.com

==== httpsavefullcfg ====
{{Optional/en}}

write config:
0 = all not empty parameters, all not default parameters, all parameters not containing the same value as the same parameter in global configuration (default)
1 = all parameters

==== httpreadonly ====
{{Optional/en}}

read only modus for web interface

httpreadonly = 1 # only read
= 0 # all is possible (default)

====httphelplang====
{{required}}

set right language for wiki entry point
de|en|fr <available wiki languages>

=== csp (TCP) ===
Section only needed if using cache exchange

{{OSCamConfcspParameter}}

==== port ====
{{required}}
NEW svn6124:12/23/2011

TCP port of Cardserverproxy for cache exchange

port = port
= [blank] none (default)

==== serverip ====
{{required}}
NEW svn 6124:12/23/2011

IP address of Cardserverproxy for cache exchange

serverip = IP
= [blank] none (default)

==== wait_time ====
{{required}}
NEW svn 6142:12/25/2011

wait_time = milli-seconds
= [blank] none (default)

wait time for cache exchange before sending ECM ti Cardserverproxy

=== Camd 33 (TCP) ===
Section required only if camd33 will be used as client protocol!

{{OSCamConfCamd33Parameter}}

==== port ====
{{required}}

TCP/IP port for camd 3.3x clients, 0 = disabled, default:0

Example:
port = 15000
= 0 # disabled (default)

==== serverip ====
{{Optional/en}}

bind service to specified IP address

Example:
serverip = 192.168.178.1

Default:
serverip = # listenig to all

==== nocrypt ====
{{Optional/en}}

unsecured camd 3.3x client connection
IP address|IP address range[,IP address|IP address range]...

Example:
nocrypt = 127.0.0.1,192.168.0.0-192.168.255.255

Default:
nocrypt = [none]

==== passive ====
{{Optional/en}}

force passive camd 3.3x client

Camd3.3x protocol generally has aktive clients. In certain circumstances the client must switched on only "passive" mode.

Example:
passive = 1

Default:
passive = 0

==== key ====
{{Optional/en}}
128 bit key

key for camd 3.3x client encryption

Example:
key = 01020304050607080910111213141516

Default:
key = # (blank] none (default)

=== camd35|cs357x (UDP) ===
Section required only if camd35|cs357x will be used as client protocol! These protocols principle encrypt and build the key from user name.

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
'''cs357x''' was also known as '''camd35''' designated. Both terms mean the same protocol with the same functions and parameters. In the future, to avoid confusion '''only cs357x''' is used.

{{OSCamConfCs357xParameter}}

==== port ====
{{required}}
UDP port for camd 3.5x|cs357x clients. Port must be opened at router!

Example:
port = 15000
= 0 # disabled (default)

==== serverip ====
{{Optional/en}}

bind service to specified IP address

Example:
serverip = 192.168.178.1

Default:
serverip = # [blank] all (default)

==== suppresscmd08 ====
{{Optional/en}}

suppresscmd08 = 0|1

0 = tell camd35|cs3.57x-clients not to request again for rejected CAID, service ID and provider ID combination (default)
1 = disabled

Can be overwritten in oscam.user!

More here:: http://streamboard.gmc.to/wbb2/thread.php?threadid=27459&threadview=0&hilight=cmd08&hilightuser=0&page=1

=== cs378x (TCP) ===
Section required only if s378x will be used as client protocol!

{{OSCamConfCs378xParameter}}

==== port ====
{{required}}
port for camd 3.5x clients. Port must be opened at router!

Example:
port = 15000

==== serverip ====
{{Optional/en}}

bind service to specified IP address

Example:
serverip = 192.168.178.1

Default:
serverip = # [blank] all (default)

==== suppresscmd08 ====
{{Optional/en}}

suppresscmd08 = 0|1

0 = tell cs3.78x clients not to request again for rejected CAID, service ID and provider ID combination (default)
1 = disable

Mor here:: http://streamboard.gmc.to/wbb2/thread.php?threadid=27459&threadview=0&hilight=cmd08&hilightuser=0&page=1

=== Newcamd (TCP) ===
Section required only if newcamd will be used as client protocol!

{{OSCamConfNewcamdParameter}}

==== key ====
{{required}}
DES key
Default key for newcamd client encryption.

Example:
key = 0102030405060708091011121314

Default:
key =

==== port ====
{{required}}
TCP port/DES key/CAID/ident definitions. Each CAID requires a separate port. If you don't specify a DES key for a port, the default DES Key will be used!

port[{DES key}]@CAID[:ident][,ident]...[;port[{DES key}]@CAID[:ident][,ident]...]...

Example:
port = 15000@1234:000000 # (CAID 1234 connected with port 15000)
port = 15000@1234:000000;15001@5678:000000 # (CAID 1234 connected with port 15000. CAID 5678 with port 15001)

Default:
port = port@caid:ident

==== serverip ====
{{Optional/en}}

bind service to specified IP address

Example:
serverip = 192.168.178.1

Default:
serverip = [blank]

==== allowed ====
{{Optional/en}}

client connections allowed from
IP address|IP address range[,IP address|IP address range]...

!! Dyn DNS Addresses are not forseen here and won't work !!

Example:
allowed = 127.0.0.1,192.168.0.0-192.168.255.255

Default:
allowed = [blank]

==== keepalive ====
{{Optional/en}}

Example:
keepalive = 1 # (enabled)
keepalive = 0 # (disabled)

Default:
keepalive = 0

==== mgclient ====
{{Optional/en}}

Enable mgcamd extended newcamd protocol, allowing for a single connection to work with mutliple providers, default:0

Example:
mgclient = 1 # (enabled)
mgclient = 0 # (disabled)

Default:
mgclient = 0

=== Radegast ===
Section required only if radegast will be used as client protocol!

{{OSCamConfRadegastParameter}}
==== port ====
{{required}}

TCP/IP port for radegast clients (enables radegast)
port =
= 0 (default)

==== serverip ====
{{Optional/en}}
bind service to specified IP address

Example:
serverip = 192.162.9.1
= [blank] alle IP'as allowed (default)!

==== allowed ====
{{Optional/en}}

client connections allowed from
IP addres|IP range[,IP address|IP range]...

Example:
127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed

==== user ====
{{required}}

user name for radegast client
user = username

=== Serial ===
Section required only if seral interface will be used!

{{OSCamConfSerialParameter}}

==== device ====
{{Optional/en}}

Parameter of device
device = <user>@<device>[:baud][?option1=value1][?option2=value2]

Parameter
user = account
device = name of Serial Device
option = timeout = milli seconds timeout for connection default: 50
= delay milli seconds additive between 2 characters

supported serial devices
HSIC Humax Sharing Interface Client
SSSP Simple Serial Sharing Protocol
bomba BOMBA Firmware
dsr9500 DSR 9500

=== Cccam (TCP) ===
Section required only if Cccam will be used as client protocol!
{{OSCamConfCccamParameter}}

==== port ====
{{required}}
CHANGE svn6206:01/07/2012

Port = 0|port[,port...]

TCP/IP-Ports for CCcam clients, enables Cccam protocol!

port =
= 0 # CCcam-Protokoll disabled (default)

==== version ====
{{Optional/en}}

define CCcam version, minimum CCcam version 2.0.11, used with original CCcam only, default:none

<nowiki><main version>,<version>,</nowiki>

Example:
version = 2.0.11

==== reshare ====
{{Optional/en}}

reshare level for CCcam clients:
0 = no resharing
1 = resharing for direct peer only
2 = resharing for direct peer and next level
x = resharing for direct peer and next x level (x for number of level)
10 = (default)

Example:
reshare = 1 resharing only for direct peer

reshare could be defined on 2 ways:

* reader ("cccreshare")
* user-account ("cccreshare")

A cards reshare value is set to the smallest value of the 2 parameters !

==== reshare_mode ====
{{Optional/en}}

CCcam reshare mode
0 = reader reshares only received SCs for CCcam readers,
defined filters/CAIDs/idents on other readers (default)
1 = reader reshares received SCs (like=0) and defined services
2 = reader reshares only defined reader services as virtual SCs
3 = reader reshares only defined user services as virtual SCs
4 = reader reshares only received cards

Every server is shared as hop=0 and with defined reshare values.

Service reshare only works if positive services defined: no service - no reshare!

==== ignorereshare ====
{{Optional/en}}

CCcam reshare setting:
0 = use reshare setting of server (default)
1 = use reshare setting of reader or user

Example:
ignorereshare = 1 reshare settings of reader or user are used

==== stealth ====
{{Optional/en}}

Behaviour like the original CCcam: no activate partner detection and extended OSCam-CCcam protocol, prevent other OSCam to detect the server as OSCam server.

stealth = 1 # stealth enabled
= 0 # stealth disabled (default)

==== minimizecards ====
{{Optional/en}}

mode how to provide CCcam servers to CCcam clients:
0 = no aggregation, remove duplicates only (default)
1 = based on minimum hop: two SCs with different hops are summarized, new SCs get a smaller hop

==== updateinterval ====
{{Optional/en}}

interval to provide share list update to CCcam clients in seconds
0 = update based on server updates
-1 = disable
= [blank] 240 (default)

==== keepconnected ====
{{Optional/en}}

set CCcam keepalive modus:
0 = disconnect client when max idle time is reached
1 = keep client connected (default)

==== forward_origin_card ====
{{Optional/en}}

forward_origin_card = 0|1

1 = forward ECM request to reader holding this card, loadbalancer, fallback and caching will be disabled
0 = default

==== nodeid ====
{{Optional/en}}

nodeid = ID

set CCcam node ID in hex, default:none

example
nodeid = 0a0b0c0d0e0f1011

=== Pandora ===
{{OSCamConfPandoraParameter}}

==== pand_skip_send_dw ====

pand_skip_send_dw = dummy

==== pand_allowed ====

pand_aloowed = dummy

==== pand_usr ====

pand_user = dummy

==== pand_pass ====

pand_pass = dummy

==== pand_ecm ====

pand_ecm = dummy

==== pand_port ====

pand_port = dummy

==== pand_srvid ====

pand_srvid = dummy

=== GBox ===

[[Datei:UnderConstruction.jpg|text-bottom]] '''Under Construction'''

No description of parameters until a certain point of devellopment is reached!

{{OScamConfGboxParameter}}

==== hostname ====

==== port ====

==== maxdist ====

==== maxecmsend ====

==== greshare ====

==== localcard ====

=== DVBapi ===
{{Optional/en}}

Section required only if OSCam will also be used as client!

{{OSCamConfDVBapiParameter}}

==== enabled ====
{{Optional/en}}

DVB API enabled

Example:
enabled = 0 # disabled (default)
enabled = 1 # enabled

==== user ====
{{required}}
user name for DVB API client
Example:
user = # user1

Default:
enabled = # anonymous

==== au ====
{{Optional/en}}

AU mode for dvbapi:
0 = disable AU, default
1 = enable AU
2 = enable AU, override AU settings of client, set answering reader as AU reader

==== pmt_mode ====
{{Optional/en}}
PMT mode:
pmt_mode = 0 # use camd.socket and PMT file (default)
pmt_mode = 1 # disable reading PMT file
pmt_mode = 2 # disable camd.socket
pmt_mode = 3 # read PMT file on startup only
pmt_mode = 4 # do not use signal handler for monitoring /tmp
pmt_mode = 5 # do not use signal handler to monitor /tmp & disable camd.socket

==== request_mode ====
{{Optional/en}}
CAID request mode:
0 = try all possible CAIDs one by one (default)
1 = try all CAIDs simultaneously

==== boxtype ====
{{required}}
set boxtype, auto detection of DVB API will be aspired:
boxtype = dbox2|dreambox|dm7000|duckbox|ufs910|ipbox|ipbox-pmt|qboxhd|coolstream|neumo|pc

Default:
boxtype = dreambox

ipbox with camd.socket support, currently only with PGI image version 0.6 or above, verified on HD models only

ipbox-pmt can be used on any DGS based images (with or without camd.socket support), verified on HD models only

pc is for generic pc support (currently supported on VDR with vdr-plugin-dvbapi)

==== cw_delay ====
{{Optional/en}}
NEW svn4348:02/05/2012

cw_delay = milli-seconds

delay of CW writing, default = none

==== reopenonzap ====
{{Optional/en}}
NEW svn4348:02/05/2012

reopenonzap = 0|1
= 1 reopen demux devices in each channel switching,
= 0 default

=== Anticasc ===
Section is needed if anticascading will be used to protect against unauthorized forwarding CardSharing.
{{OSCamConfAnticascParameter}}

==== enabled ====
{{required}}

enabled anti-cascading:
enabled = 1 # enabled
= 0 # disabled (default)

==== numusers ====
{{Optional/en}}
anti-cascading: user per account (number)
numusers = 0 # anticascading disabled (default)
= 1 # cascading for 1 user allowed ==> (1*100+80)/(10*100/60) = 11 ecms allowed per minute
= 2 # cascading for 2 users allowed ==> (2*100+80)/(10*100/60) = 17 ecms allowed per minute 
10 = number you have put in oscam.ac. Default value is 10

==== sampletime ====
{{Optional/en}}
duration of sample in minutes:
sampletime = 5 # duration 5 minutes
= # [blank] duration 2 minutes (default)

Ex: numusers = 1 ==> 11 ecms * 5 minutes ==> 55 ecms allowed in 5 minutes
numusers = 2 ==> 17 ecms * 5 minutes ==> 85 ecms allowed in 5 minutes

==== samples ====
{{Optional/en}}

number of additionnal ecms allowed (possible values between 2 and 10)
samples = 7 # 7 additional ecms allowed
= # [blank] 10 additional ecms allowed (default)

==== penalty ====
{{Optional/en}}
Level of the penalty if the user exceeds the result shown in Ex on Sampletime
0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay ([[OSCam/en/Config/oscam.conf#fakedelay|fakedelay]])

penalty can be overwritten per user in oscam.user

==== aclogfile ====
{{Optional/en}}
file for anti-cascading logging
aclogfile =
= # [blank] no logfile (default)

==== fakedelay ====
{{Optional/en}}

fake delay time in milli seconds (possible values between 100 and 3000)
fakedelay = 500 # delay 500 milli seconds
= # [blank] 1000 milli seconds (default)

==== denysamples ====
{{Optional/en}}

How many samples should be penalized?
denysamples = 10 # 10 samples will be penalized
= # [blank] 8 Samples will penalized (default)

{{OSCamTranslatedLinks}}

Streamboard Wiki - Benutzerbeiträge [de-at]

OSCam/en/Config/oscam.conf