Streamboard Wiki - Benutzerbeiträge [de-at]

OSCam/en/Config/oscam.user

2017-02-10T15:24:39Z

Pr2: /* allowedtimeframe */ Mention the full day range: 00:00-24:00

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

== oscam.user ==
The user configuration file for OSCam contains user definitions. [account] sections in oscam.user are recurring (more than one account).

=== [account] ===
{{OSCamUserParameter}}

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

account name

Example:
user = user1

Default:
user =

==== pwd ====
{{required}}

password for account

Example:
pwd = pwuser1

Default:
pwd =

==== description ====
{{Optional/en}}
description of user account (text)

Описание аккаунта пользователя (текст)

==== disabled ====
{{Optional/en}}

account disabled

Beispiel:
disabled = 0 # (account enabled)
disabled = 1 # (account disabled)

Default:
disabled = 0

==== hostname ====
{{Optional/en}}
host from which user connection is allowed

Example:
hostname = client.dyndns.org

Default:
hostname =

==== expdate ====
{{Optional/en}}

expiration date for account

Format:
<year>-<month>-<day>|<year>/<month>/<day>

Example:
expdate = 2001-11-21
expdate = 2002/12/22

Default:
expdate = none

==== allowedprotocols ====
{{Optional/en}}

allowedprotocols = [protocol1][,][protocol2][,][protocol3][,]...

allowed protocols for user

protocols
camd33
camd35
cs357x
cs378x
newcamd
cccam
gbox
radegast

example
allowedprotocols = cs357x,gbox # only cs357x and gbox protocols are allowed
= [blank] # all protocols are allowed (default)

==== allowedtimeframe ====
{{Optional/en}}

account enabled from - to for specified day(s)

Format:
DAY@HH:MM-HH:MM[,HH:MM-HH:MM][,HH:MM-HH:MM][;DAY@HH:MM-HH:MM[,HH:MM-HH:MM][,HH:MM-HH:MM]]
where DAY=SUN,MON,TUE,WED,THU,FRI,SAT or ALL (for all possible days)

comma (,) to separate times and semicolon(;) to separate the different days.
You can use ALL@ if you want the same time frames for everyday.

Day starts at 00:00 and end at 24:00, so to cover a full day use: DAY@00:00-24:00

Example:
allowedtimeframe = ALL@10:00-22:00;MON@00:00-02:00,02:45-04:37;FRI@00:00-10:00,22:00-24:00;SAT@00:00-24:00

If you use: XXX@22:00-05:00 this will be turned into XXX@00:00-05:00,22:00-24:00 
ALL@ is always checked and used, so you can watch TV the whole day on FRIday in this exemple. There is no problem to overlap ALL@ in a day definition, like for SAT@ definition.

Default:
allowedtimeframe =

==== uniq ====
{{Optional/en}}

Example:
uniq = 0 # disabled, default
uniq = 1 # only one connection per user is allowed
uniq = 2 # set user to fake if source ip is different
(e.g. for newcamd clients with different CAIDs and ports)
uniq = 3 # only one connection per user, but only the last login will survive (old mpcs behavior)
uniq = 4 # set user only to fake if source ip is different, but only the last login will survive

Default:
uniq = 0

==== numusers ====
{{Depends/en}}

used only '''if anticascading''' is enabled!

numusers = # quantity

user per account

Example:
numusers = -1 # (global value from oscam.conf, default)
numusers = 5 # (maximal 5 user)
numusers = 0 # (anticascading disabled)

==== penalty ====
{{Depends/en}}

used only if '''anticascading''' is enabled!

level of penalty:
'''penalty = -1''' # use value of [[OSCam/en/Config/oscam.conf#penalty|penalty]] defined in oscam.conf ('''default''')
penalty = 0 # only logging
penalty = 1 # send fake DWs
penalty = 2 # ban user temporary
penalty = 3 # send DWs with delay ([[OSCam/en/Config/oscam.conf#fakedelay|fakedelay]])

==== fakedelay ====
{{Optional/en}}
NEW svn7785:10/22/2012

fakedelay = milli seconds or 0|-1

se fake delay time individually for user

0 = fake delay disabled
-1 = fake delay of oscam.conf[global] (default)
= fake delay in milli seconds for user

==== failban ====
{{Optional}}

CHANGE svn 7772:10/21/2012

mask for IP based blocking:

failban = 0|2|4|8

failban = 0 # ignore (default)
failban = 2 # block IP address of a disabled account on connecting
failban = 4 # block IP address of a sleeping account while sleeping comes up
failban = 8 # block duplicate IP address
 
 

==== acosc_max_active_sids ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014 

acosc_max_active_sids = count

maximum active SIDs with anti-cascading over SID
 
0 = unlimited, default
-1 = use global setting from oscam.conf [global]
 
 

==== acosc_zap_limit ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_zap_limit = count
 
zap-limit for anticascading over SID
 
0 = unlimited, default
-1 = use global setting from oscam.conf.[global]
 
 
==== acosc_penalty ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_penalty = 0|1|2|3|-1
 
level of penalty with anti-cascading over SID
 
0 = only logging, default
1 = send fake CW's
2 = temporary user ban
3 = send delayed CW's
-1 = use global setting from oscam.conf [global]
 
 
==== acosc_penalty_duration ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_penalty_duration = seconds
 
penalty duration for anti-cascading over SID
 
0 = mone, default
-1 = use global setting from oscam.conf[global]
 
 
==== acosc_delay ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_delay = milli-seconds
 
Dauer des delay für anti-cascading über SID
 
0 = none, default
-1 = use global setting Oscam.conf[global]
 
 

==== lb_nbest_readers ====
{{Optional/en}}
NEW svn8642:05/10/2013

lb_nbest_readers = count

set count of best readers for load balancing

-1 = use global lb_nbest_readers in oscam.conf
1 = default

==== lb_nbest_percaid ====
{{Optional/en}}
NEW svn8642:05/10/2013

lb_nbest_percaid = CAID1:count1[,CAID2:count2]...

set count of best readers per CAIDs for load balancing, wildcards CAIDs with two-digit CAIDs possible.
default = none

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

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

NEW svn 10050:11/30/2014

preferlocalcards = 0|-1|1|2

-1 = global value from oscam.sonf[global] (default)
0 = local SCs used like a remote reader
1 = prefer call exchange based SCs
2 = prefer local SCs

==== cwc_disable ====
{{Optional/en}}
NEW svn 10049:11/30/2014

cwc_disable = 0|1

1 = disable cw cycle check
0 = default

==== cacheex ====
{{Optional/en}}
NEW svn6039:11/26/2011

cacheex = 0|1|2|3

1 = enable cache exchange pull mode
2 = enable cache exchange push mode
3 = enable cache exchange reversepush mode
0 = default
for camd 3.5x and CCcam protocol

see also on oscam.server!

Identical cache exchange modes must be set on local OSCam user account and remote OSCam server!

===== cacheex-modes =====
===== cacheex = 1 - cachepull =====
Situation:

OSCam A reader1 has cacheex = 1

OSCam B account1 has cacheex = 1

OSCam A gets a ECM request, reader1 send this request to OSCam B,

OSCam B checks his cache:
* Not found in cache: return NOK
* Found in cache: return OK+CW
* Not found in cache, but found pending request: wait ''cacheexwaittime'' in oscam.conf [global] and check again. OSCam B never requests new ECMs.

CW-flow = B ---> A

===== cacheex = 2 - cachepush =====
Situation:

OSCam A reader1 has cacheex = 2

OSCam B account1 hastcacheex = 2

If OSCam B gets a CW, its pushed to OSCam A, reader has normal functionality and can request ECMs.
* Problem: OSCAM can only push CW's if OSCam A is connected
* Problem or feature?: OSCam A reader can request ECMs from OSCam B

CW-flow = B ---> A

===== cacheex = 3 - reversecachepush =====
Situation:

OSCam A reader 1 has cacheex = 3

If OSCam A gets a CW, its pushed to OSCam B. OSCam A never requests new ECMs.

CW-flow = A ---> B

==== cacheex_maxhop ====
{{Optional/en}}
NEW svn6691:05/07/2012

cacheex_maxhop = hops
= defaolt = 10 hops

define maximum hops for cache exchange

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

time waiting for inactive user in minutes

Example:
sleep = 5

Default:
sleep =

==== sleepsend ====
{{Optional/en}}
0|255

255 = '''OSCam client''' only: stopping requests until next zap,

255 = '''camd 3.x''' only: stopping requests until restart of camd3 client

Examples:
sleepsend = 0
sleepsend = 255

Default:
sleepsend =

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

switches suppress of CMD08

suppresscmd08 = 0 # CMD08 for camd3 3.57x/3.78x clients '''enabled'''
suppresscmd08 = 1 # CMD08 for camd3 3.57x/3.78x clients '''disabled'''

Default:
suppresscmd08 = 0

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

disable keepalive between newcamd-server and client connection

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

==== umaxidle ====
{{Optional/en}}

NEW svn8929:09/25/2013

CHANGE svn 9801:07/17/2014

umaxidle = seconds

value for user being idle before disconnect.

-1 = use clientmaxidle in [global]-section
0 = idle disconnect disabled (default)

==== caid ====
{{Optional/en}}

caid = <CAID>[&<mask>][:<target CAID>][,<CAID>[&<mask>][:target <CAID>]]...

define and mapping of CAIDs for reader, default:all CAIDs with mask FFFF

example:
caid = 0100
caid = 0200&ffee:0300
caid = 0400&ff00:0500,0600
caid = 0702,0722
caid = 0702&ffdf (shortcut for the example above)

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

Format:
label of reader[,label of reader]...|1

AU settings:
au = [label of reader] # sending EMMs to specified reader
(security issue: clients can see SC data!)
au = 1 # auto AU is sending EMMs to all readers
(security issue: clients can see SC data!)
Default:
au = [blank] # none

Sometimes only global emm's update '''same caid cards''':

- check if you blocked unique/shared in READER Blockemm

- don't use au = 1, use au = [label of reader]

- if still troublesome use '''in house''' different user to update each card by [label of reader]

example: cd__nl and tv__vl have a common provider: m7 group sa and share updates on shared channels.

user 1: AU: cd__nl,sky_uk

user 2: AU: tv__vl

==== group ====
{{required}}
CHANGE svn6103:12/21/2011

user assingment to reader group. Valid 64 groups

Format:
group = 1....64[,1....64]....
default = none

==== betatunnel ====
{{Optional/en}}

define Betacrypt tunneling (max. see CS_MAXTUNTAB in globals.h). The ServiceID can also be used for wildcarded CAIDs.

Format:
<CAID>.<ServiceID>:<target CAID>[,<CAID>.<ServiceID>: <target CAID>]...

Example:
betatunnel = 0100.0001:0200,0300.0004:0500
betatunnel = 0600.FFFF:0700

Default:
betatunnel =
 

==== emmreassembly ====
{{Optional/en}}

NEW svn8591:01/04/2013

emmreassembly = 0|1||2

EMM reassembly, should be set for Viaccess and Cryptoworks readers if the client that you are using to send EMMs is reassembling them instead of just sending them to OSCam for processing.

0: disabled
1: enabled for DVB API
2: enabled (default)

==== services ====
{{Optional/en}}

What services may use the User.? This requires a oscam.services be present. The logic here is as follows (in this order):
* If the field is empty (or invalid), the request is allowed.
* When a negative service (ie, those with '''!''') is applicable, the request is rejected.
* If a positive service is applicable or there is no positive service, the request is allowed.
* If none of the previous points, the request is rejected.
This means that negative Services are only necessary in individual cases. Namely, exactly, then if you have a positive service, but it wants to exclude some back. This is not recommended, because here comes quickly to misconfigurations. Instead, an additional service to be created that contains all the relevant channels.

Example:
services = service1,!service2 # (client may receive service1, but not service2)
services = [!]services

Default:
services =

==== ident ====
{{Optional/en}}

user assingment to SC specific idents

Format:
<CAID>:<ident>[,<ident>,...][;<CAID>:<ident>[,<ident>,...]]...

default = none

==== class ====
{{Optional/en}}

user [de]assingment to SC specific classes

Format:
[!]class[,[!]class]...

Example:
class = 01,02,!03,!04

default = none

==== chid ====
{{Optional/en}}

user assingment to SC specific ChID

Format:
chid = <CAID>:<ChID>[,<ChID>,...][;<CAID>:<ChID>[,<ChID>,...]]...
= [blank] default

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

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

==== ccc ====

===== cccmaxhops =====
{{Depends/en}}
only if '''CCcam proxies or CCcam server''' are used!

maximum hops limit for CCcam clients

cccmaxhops = -1 # CCcam disbled for this user
0 # local SCs only
1 # local SCs + 1 hop
2 # local SCs + 2 hops
# and so on

Default:
cccmaxhops = 10 # local SC's + 10 hops

===== cccreshare =====
{{Depends/en}}

CHANGE svn8608:04/10/2013

reshare level for CCcam clients

Example:
cccreshare = -1 # use [[OSCam/en/Config/oscam.conf#reshare|reshare]] level defined in oscam.conf - default
= 0 # reshare for direct peer only
= 1 # resharing for direct peer and next level

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 !

===== cccignorereshare =====
{{Depends/en}}

only if '''CCcam proxies or CCcam server''' are used!

CCcam ignore reshare settings

cccignorereshare = -1 # use ignore reshare level of oscam.conf [ccc] - default
= 0 # use ignore reshare level of server
= 1 # use ignore reshare level of reader or user

===== cccstealth =====
{{Depends/en}}

cccstealth = -1|0|1

-1 = # use CCcam stealth of oscam.conf [ccc] - default
0 = # use extendet OSCam-CCcam-protocol
1 = # behaviour like the original CCcam-protocol, no activate partner detection and extendet
OSCam-CCcam-protocol, prevent other OSCam to detect the server as OSCam-server

{{OSCamTranslatedLinks}}

OSCam/de/Config/oscam.user

2017-02-09T17:06:32Z

Pr2: /* allowedtimeframe */ Extended allowed timeframe

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

== '''oscam.user''' ==
Diese Datei enthält Userdefinitionen. Für jeden User muss ein Abschnitt erstellt werden.

=== '''Account''' ===
{{OSCamUserParameter}}

==== user ====
{{Mandatory}}
Hier wird der Benutzername eingefügt. (Clientname)

Beispiel:
user = user1

Default:
user =

==== pwd ====
{{Mandatory}}
Hier wird das Passwort festgelegt.

Beispiel:
pwd = pwuser1

Default:
pwd =

==== description ====
{{Optional}}
Es kann eine Beschreibung des Users eingetragen werden

'''Nicht zu verwechseln mit ''user und pwd''!''' Dient für '''zusätzliche''' Informationen über den user z.B. Örtlichkeit, Rechte usw.

==== disabled ====
{{Optional}}
User sperren.

Beispiel:
disabled = 0 # (User ist aktiv)
disabled = 1 # (User ist gesperrt)

Default:
disabled = 0

==== hostname ====
{{Optional}}
Oscam akzeptiert nur Clientverbindungen des Users vom eingetragenen Host. IP oder DNS ist möglich.

Beispiel:
hostname = client.dyndns.org

Default:
hostname =

==== expdate ====
{{Optional}}
Wie lange ist der User gültig.

Beispiel:
expdate = 2099-12-31 # (Gültig bis 31.12.2099)
expdate = <year>-<month>-<day>|<year>/<month>/<day>

Default:
expdate =

==== allowedprotocols ====
{{Optional}}
NEU svn 5662:07/2011

allowedprotocols = [protocol1][,][protocol2][,][protocol3][,]...

Hier kann festgelegt werden, welche Protokolle der User benutzen darf. Die Zugriffsmöglichkeiten auf den Server können damit eingeschränkt werden!

Mögliche Protokolle
camd33
camd35
cs357x
cs378x
newcamd
cccam
gbox
radegast

Beispiel
allowedprotocols = cs357x,gbox # Der User darf nur mit den Protokollen cs357x und gbox auf den Server zugreifen
= [blank] # alle möglichen Protokolle sind erlaubt (default)

==== allowedtimeframe ====
{{Optional}}

account enabled from - to for specified day(s)

Format:
DAY@HH:MM-HH:MM[,HH:MM-HH:MM][,HH:MM-HH:MM][;DAY@HH:MM-HH:MM[,HH:MM-HH:MM][,HH:MM-HH:MM]]
where DAY=SUN,MON,TUE,WED,THU,FRI,SAT or ALL (for all possible days)

comma (,) to separate times and semicolon(;) to separate the different days.
You can use ALL@ if you want the same time frames for everyday.

Example:
allowedtimeframe = ALL@10:00-22:00;MON@00:00-02:00,02:45-04:37;FRI@00:00-10:00,22:00-24:00;SAT@00:00-24:00

If you use: XXX@22:00-05:00 this will be turned into XXX@00:00-05:00,22:00-24:00 
ALL@ is always checked and used, so you can watch TV the whole day on FRIday in this exemple. There is no problem to overlap ALL@ in a day definition, like for SAT@ definition.

Default:
allowedtimeframe =

==== uniq ====
{{Optional}}
Mit Uniq wird geregelt, ob sich ein Client gleichzeitig nur einmal oder mehrmals anmelden darf

Beispiel:
uniq = 0 # (deaktiviert)
uniq = 1 # (Nur eine Verbindung pro User ist erlaubt)
uniq = 2 # (Setzt User auf Fake, wenn die IP unterschiedlich ist)
uniq = 3 # (Erlaubt nur eine Verbindung pro User, die letzte Verbindung bleibt bestehen)
uniq = 4 # (Setzt User auf Fake, wenn die IP unterschiedlich ist, aber der letzte Login bleibt erhalten)

Default:
uniq = 0

==== numusers ====
{{Depends}}
Wird nur benötigt wenn Anti-Cascading aktiviert ist.
Anzahl der zugelassenen User pro Account

numusers = quantity

Beispiel:
numusers = 5 # (Maximal 5 User)
numusers = 0 # (Anti-Cascading deaktiviert, default)

==== penalty ====
{{Depends}}
Wird nur benötigt wenn Anti-Cascading aktiviert ist.
Was passiert, wenn der Wert numuser überschritten wird.

penalty = 0|1|2|3

Beispiel:
penalty = 0 # (Es wird nur geloggt)
penalty = 1 # (Sendet Fake CW's)
penalty = 2 # (deaktiviert temporär den Account)
penalty = 3 # sendet delayed CW's
penalty = -1 # es werden die Werte aus der oscam.conf benutzt (default)

==== fakedelay ====
{{Optional}}
NEU svn7785:10/22/2012

fakedelay = Millisekunden oder 0|-1

setzt die fakedelay-time individuell für den User

0 = fakedelay disabled
-1 = fakedelay aus der oscam.conf[global] verwenden (default)
= Wert für den User in Millisekunden

==== failban ====
{{Optional}}
Was passiert wenn der Wert numuser überschritten wird.

ÄNDERUNG svn 7772:10/21/2012

failban = 0|2|4|8

failban = 0 # ignoriert (default)
failban = 2 # Blockt die IP wenn sich ein deaktivierter Client verbindet
failban = 4 # Blockt die IP eines schlafenden Accounts während des Schlafes
failban = 8 # Blockt duplizierte IP

==== acosc_max_active_sids ====
{{Optional}}
NEU svn 7940:05/20/2014 

acosc_max_active_sids = Anzahl

Maximale Zahl activer SIDs mit anti-cascading über SID

0 = unbegrenzt, default
-1 = benutze die Einstellungen aus oscam.conf [global]

==== acosc_zap_limit ====
{{Optional}}
NEU svn 7940:05/20/2014

acosc_zap_limit = Anzahl

Zap-Limit für anti-cascading über SID

0 = unbegrenzt, default
-1 = benutze die Einstellungen aus oscam.conf. [global]

==== acosc_penalty ====
{{Optional}}
NEU svn 7940:05/20/2014

acosc_penalty = 0|1|2|3|-1

Penalty-Level für anti-cascading über SID

0 = nur loggen, default
1 = sende fake CW's
2 = vorübergehendes Bannen des Users
3 = sende verzögerte CW's
-1 = benutze die Einstellungen aus oscam.conf [global]

==== acosc_penalty_duration ====
{{Optional}}
NEU svn 7940:05/20/2014

acosc_penalty_duration = Sekunden

Dauer der acosc_penalty für anti-cascading über SID

0 = keine, default
-1 = benutze die Einstellungen aus Oscam.conf [global]

==== acosc_delay ====
{{Optional}}
NEU svn 7940:05/20/2014

acosc_delay = Millisekunden

Dauer des delay für anti-cascading über SID

0 = kein, default
-1 = benutze die Einstellungen aus Oscam.conf [global]

==== lb_nbest_readers ====
{{Optional}}
NEU svn8642:05/10/2013

ln_nbest_readers = Anzahl

setzt die Anzahl der besten Reader für das Loadbalancing.
-1 = benutze den Eintrag unter oscam-conf[global] für diesen Parameter
1 = default

==== lb_nbest_percaid ====
{{Optional}}
NEU svn8642:05/10/2013

lb_nbest_percaid = CAID1:count1[,CAID2:count2]...

setzt die Anzahl der besten reader pro CAID für das Loadbalancing. Wildcards CAID's mit 2-digit CAIDs sind möglich.

Beispiel
lb_nbest_percaid = 0100:4,0200:3,03:2,04:1
(Wildcards CAIDs 03xx und 04xx)

==== preferlocalcards ====
{{Optional}}
NEU svn 10050:11/30/2014

preferlocalcards = 0|-1|1|2

-1 = es werden die Werte aus oscam.conf[global] verwendet (default)
0 = lokale Karten werden wie ein remote Reader verwendet
1 = verwende cache exchange basierte Karten
2 = verwende lokale Karten

==== cwc_disable ====
{{Optional}}
NEU svn 10049:11/30/2014

cwc_disable = 0|1

1 = disable cw cycle check
0 = default

==== cacheex ====
{{Optional}}
NEU svn6039:11/26/2011

cacheex = 0|1|2|3

1 = enable cache exchange pull mode
2 = enable cache exchange push mode für camd 3.5x und CCcam Protokolle
3 = enable cache exchange reversepush mode
0 = default
für camd 3.5x und CCcam Protokolle

Identische cache exchange modes müssen bei local OSCam user account und remote OSCam Readern gesetzt sein!

[[Datei:MessageS.png|text-bottom]]'''Ein ausführliches How-To findet man hier [[Streamboard-Post:406230|Streamboard-Post]]'''

===== cacheex-modes =====
===== cacheex = 1 - cachepull =====
Situation:

OSCam A reader1 ist gesetzt auf cacheex = 1

OSCam B account1 ist gesetzt auf cacheex = 1

OSCam A erhält eine ECM Anfrage, reader1 sendet diese Anfrage an OSCam B,

OSCam B prüft seinen cache:
* im cache wird nichts gefunden: OSCam B sendet: NOK
* im cache wird etwas gefunden; OSCam B sendet: OK+CW
* im cache wird nichts gefunden aber es wird eine anstehende Anfrage festgestellt: ''cacheexwaittime'' in oscam.conf [global] wird abgewartet und dann erneut geprüft. OSCam B fragt nicht mehr nach neuen EMMs.

CW-flow = B ---> A

===== cacheex = 2 - cachepush =====
Situation:

OSCam A reader1 ist gesetzt auf cacheex = 2

OSCam B account1 ist gesetzt auf cacheex = 2

Wenn OSCam B ein CW erhält, wird es auf OSCam A geschoben. Der Reader hat normale Funktionen und kann ECMs anfragen.
* Problem: OSCAM kann nur dann CW's auf OSCam A schieben, wenn OSCam A verbunden ist
* Problem oder feature?: OSCam A kann ECMs von OSCam B anfragen

CW-flow = B ---> A

===== cacheex = 3 - reversecachepush =====
Situation:

OSCam A reader 1 ist gesetzt auf cacheex = 3

Wenn OSCam A ein CW erhält, wird dies auf OSCam B geschoben. OSCam A fragt nicht mehr nach neuen ECMs

CW-flow = A ---> B

==== cacheex_maxhop ====
{{Optional}}
NEU svn6691:05/07/2012

cacheex_maxhop = Anzahl der hops
= default = 10 hops

definiert das maximum an hops für cache exchange

==== sleep ====
{{Optional}}
Ein User wird automatisch "inaktiviert", wenn dieser innerhalb der eingestellten "sleep"-Zeit ECMs auf ein und demselben Sender anfordert. Der User kann sich selbst wieder "aktivieren", indem er einfach den Sender wechselt. Nach einem Senderwechsel wird der "sleep"-Timer wieder zurückgesetzt.

Beispiel - Angaben in Minuten:
sleep = 240 # 4 Stunden

Default:
sleep =

==== sleepsend ====
{{Optional}}
Wenn der "sleep"-Timer abgelaufen ist, sendet der Client dennoch weiterhin Anfragen, die OSCam mit "sleeping" beantwortet und loggt. Um diese Anfragen abzustellen, kann "sleepsend" genutzt werden.

"sleepsend" wird nur von einigen SoftCAMs unterstützt und hat folgende Auswirkungen:
* OSCam: Nur OSCam Clients mit Protokoll "Camd 3.x" oder CCcam (ab Build 5671)
** Stoppt nach Ablauf der unter "sleep" eingestellten Zeit weitere Anfragen, bis der Client einmal Umschaltet
* Camd 3.x:
** Stoppt nach Ablauf der unter "sleep" eingestellten Zeit weitere Anfragen, bis Camd 3.x neugestartet wird

Beispiel:
sleepsend = 255 # aktiviert

Default:
sleepsend =

==== suppresscmd08 ====
{{Optional}}
Nur wenn als Protokoll camd3|3.57x|3.78x verwendet wird. Das CMD08 ist ein Command, welches dem Client mitteilt, dass die Anfrage unerwünscht ist (rejected). Camd3 und Oscam als Client stellen auf dieses Command hin die Anfragen für diesen Service an den Server ein. Sollte der Wert beim User nicht gesetzt sein, gilt der globale Wert aus der oscam.conf. Das Command kann mit dem undokumentierten Parameter sleepsend=0|255 ergänzt werden (CMD08 senden bei status 'sleep').

'''Zur Beachtung:''' Camd3 clients sperren die Anfrage bis zum Neustart. Oscam Clients sperren die Anfrage bis zum nächsten Zap. Sleepsend=255 sollte also nur bei Oscam Clients verwendet werden da ein Camd3 Client nach einem Sleepstatus einen Neustart bräuchte um diesen Service wieder anzufragen.

Beispiel:
suppresscmd08 = 0 # (aktiviert)
suppresscmd08 = 1 # (deaktiviert)

Default:
suppresscmd08 = 0

==== keepalive ====
{{Optional}}
Die Verbindung zwischen Newcamd-Server und Client wird aufrechterhalten

Beispiel:
keepalive = 0 # (deaktiviert)
keepalive = 1 # (aktiviert)

Default:
keepalive = 1

==== umaxidle ====
{{Optional}}
NEU svn8929:09/25/2013

ÄNDERUNG svn 9801:07/17/2014

umaxidle = in Sekunden

Zeitraum nach dem ein im idle befindlicher user getrennt wird.

-1 = verwende Parameter ''clientmaxidle'' in der [global]-section
0 = idle disconnect ist ausgeschaltet (default)

==== caid ====
{{Optional}}
caid = <CAID>[&<mask>][:<target CAID>][,<CAID>[&<mask>][:target <CAID>]]...

definiert und mapped CAIDs für Reader

Beispiele:
caid = 0100
caid = 0200&ffee:0300
caid = 0400&ff00:0500,0600
caid = 0702,0722
caid = 0702&ffdf (shortcut für das Beispiel oben)
default: alle CAIDs mit der Maske FFFF

==== au ====
{{Optional}}
Hier wird dem User erlaubt, EMM's an alle, eine bestimmte, oder mehrere reader zu schicken.

Beispiel:
au = 1
au = label_of_reader # (label_of_reader wird in der oscam.server konfiguriert)
au = label_of_reader,label_of_reader # (multiple readerliste ab build >= #4617)

Default:
au = [blank] # none

==== group ====
{{Mandatory}}
ÄNDERUNG svn6103:12/21/2011

Jeder User muss in einer oder mehrere Gruppen eingetragen sein. Damit lässt sich dann bestimmen, auf welche Reader, sofern mehrere vorhanden sind, dieser Client Zugriff haben soll. Zulässige Gruppen = 64.

group = 1....64[,1....64]....
default = kein Eintrag

Beispiel:
group = 1 # (User ist in Gruppe 1)
group = 1,2 # (User ist in Gruppe 1 + 2)

==== betatunnel ====
{{Optional}}
Der Betatunnel dient zum Mappen (Umhängen) von Sky- und KD-CAIDs, sodass z.B. 1833'er-Anfragen über 1702 beantwortet werden können.
Notwendig ist dieses Mapping eigentlich nur bei HD-Kanälen, aber es lassen sich auch alle anderen Kanäle damit "umhängen".

[[Datei:MessageS.png|text-bottom]] '''Vor- und Nachteile eines kompletten und eines aufgeschlüsselten Mappings:'''
* Bei einem '''kompletten Mapping''' "''1833.FFFF:1702''" werden alle SIDs (Programme) übersetzt. Dies hat den '''Vorteil''', dass der Client auch bei nicht HD-Sendern sofort beantwortet wird und keinen weiteren Server anfragen muss. '''Nachteil''', ein komplettes Mapping ist nicht so schnell wie ein aufgeschlüsseltes und die Anfragen benötigen 100-200ms mehr.
* Ein '''aufgeschlüsseltes Mapping''' hat "nur" den '''Vorteil''', dass die Anfrage schneller beantwortet werden kann. '''Nachteil''', Du setzt eine "beschnittene" Karte ins Share, die nur die im Betatunnel definierten Programme umhängt, obwohl sie ggf. "mehr" kann.

Die Meinungen, was ist besser und was nicht, unterscheiden sich sehr. Entscheide selbst, was das Beste für dich ist.

[[Datei:WarningS.png|text-bottom]] '''Achtung:'''
* Wenn Du den Betatunnel einsetzt und zugleich '''Services''' verwendest, musst Du auch die '''oscam.services''' '''anpassen''', z.B. caid=1702,1833 für SAT und/oder ProvIDs (Ident) sowie SRVIDs, falls welche hinzukommen.
* Ab OSCam Revision #8860 sind maximal 100 Mappings möglich, von #6092 bis #8859 max. 50, von #4347 bis #6091 max. 20 und bei vorherigen Versionen nur 16.
* Eintragungen in der oscam.conf, [global] [[streamboard:wiki/OSCam/de/Config/oscam.conf#lb_auto_betatunnel|lb_auto_betatunnel und lb_auto_betatunnel_mode]], werden durch die Verwendung eines Betatunnel-Eintrages in der oscam.user '''überschrieben/ersetzt''', wenn Loadbalancing ebenfalls verwendet wird ([[streamboard:wiki/OSCam/de/Config/oscam.conf#lb_mode|lb_mode = 1 bis n]]).

[[Datei:MessageS.png|text-bottom]] '''Weitere Informationen:'''
* Es tut nicht weh, den Betatunnel bei allen Usern einzusetzen, wenn Du eine davon betroffene Karte besitzt.
* CCcam-Clients tunneln 1833 von Haus aus (nicht 1834!), sprich hier wäre es nicht nötig, aber es tut auch hier nicht weh.
* Setze ggf. auch Prioritäten Deiner Clients, z.B. ''1702'' vor ''1833''.

Beispiele:
# betatunnel = <CAID>.<ServiceID>:<target CAID>
#
# Sky, Mapping aller 1833'er-Anfragen auf CAID 1702...
betatunnel = 1833.FFFF:1702
#
# KD, Mapping aller 1834'er-Anfragen auf CAID 1722...
betatunnel = 1834.FFFF:1722
#
# Sky, es werden NUR die HD-Kanäle gemapped...
betatunnel = 1833.0082:1702,1833.006F:1702,1833.0077:1702,1833.0084:1702,1833.0071:1702,1833.0070:1702,1833.0075:1702,1833.006A:1702,1833.006B:1702,1833.007C:1702,1833.0081:1702,1833.0072:1702,1833.0083:1702

Default:
betatunnel =

==== emmreassembly ====
{{Optional}}
NEU svn8591:04/01/2013

emmreassembly = 0|1|2

0 = schaltet Neuaufbau von EMM aus
1 = schaltet Neuaufbau von EMM '''für DVB API''' ein
2 = schaltet Neuaufbau von EMM ein (default)

Sollte bei '''Viaccess und Cryptoworks Readern''' gesetzt werden, wenn der Client, der für das Senden von EMMs benutzt wird, die EMMs neu aufbaut anstelle sie an OScam zur Bearbeitung zu senden.

==== services ====
{{Optional}}
Welche Services darf der User nutzen. Hierzu muss eine oscam.services vorhanden sein. Die Logik ist hier folgendermaßen (in der angegebenen Reihenfolge):
* Wenn das Feld leer ist (oder ungültig) wird die Anfrage erlaubt.
* Wenn ein negativer Service (also solche mit "!") zutreffend ist, so wird die Anfrage abgewiesen.
* Wenn ein positiver Service zutreffend ist oder es gar keinen positiven Service gibt, so wird die Anfrage erlaubt.
* Wenn keiner der vorigen Punkte zutrifft, so wird die Anfrage abgewiesen.
Dies bedeutet, dass negative Services nur in Einzelfällen nötig sind. Nämlich genau dann, wenn man positive Services hat, davon aber wieder einige ausnehmen will. Dies wird nicht empfohlen, da es hier schnell zu Fehlkonfigurationen kommt. Stattdessen sollte ein zusätzlicher Service angelegt werden, der alle entsprechenden Sender enthält.

Beispiel:
services = service1,!service2 # (Client darf service1 empfangen aber nicht service2)
services = [!]services

Default:
services =

==== ident ====
{{Optional}}
ident = <CAID>:<ident>[,<ident>,...][;<CAID>:<ident>[,<ident>,...]]...

Nutzeranweisungern für kartenspezifische idents

default:none

==== class ====
{{Optional}}
class = [!]class[,[!]class]...

Nutzerfestlegungen für kartenspezifische classes

default = none

Beispiel:
class = 01,02,!03,!04

==== chid ====
{{Optional}}
chid = <CAID>:<ChID>[,<ChID>,...][;<CAID>:<ChID>[,<ChID>,...]]...

Nutzerfestlegungen für kartenspezifische CHID's

default:none

==== monlevel ====
{{Optional}}
Der Monitorlevel gibt dem Client die Möglichkeit sich auf die Monitorschnittstelle des Servers zu verbinden.
Der Monitor wird in der oscam.conf konfiguriert.

Beispiel:
monlevel = 0 # (kein Zugriff auf den Monitor)
monlevel = 1 # (nur der Server und der eigene Prozess)
monlevel = 2 # (alle Prozesse aber nur anschauen)
monlevel = 3 # (alle Prozesse und neuladen der oscam.user)
monlevel = 4 # (Vollzugriff)

Default:
monlevel = 2

==== ccc ====

===== cccmaxhops =====
{{Depends}}
Nur wenn CCcam Proxies vorhanden sind oder ein CCcam Server verwendet wird.

Maximale hops die dem User erlaubt sind.

cccmaxhops = -1 # CCcam für diesen user ausgeschaltet
0 # Nur lokale Karten
1 # Lokale Karten und 1 hop
2 # Lokale Karten und 2 hops
# und so weiter

Default:
cccmaxhops = 10

===== cccreshare =====
{{Depends}}
ÄNDERUNG svn8608:04/10/2013

Reshare level für CCcam-Client

cccreshare = -1 # benutze den reshare-level der oscam.conf [ccc] - default
= 0 # Reshare nur für direct peer
= 1 # Reshare für direct peer und nächsten Level

'''schlocke:'''

reshare kann auf 3 verschiedene Arten definiert werden:

- über oscam.server [reader] ("cccreshare")

- über oscam.conf [cccam] ("reshare")

- über oscam.user [account] ["cccreshare")

Ein reshare Wert wird auf den kleinsten Wert aller Parameter gesetzt!
Wenn der Wert < 0 ist, wird die Karte nicht reshared.

===== cccignorereshare =====
{{Depends}}
Nur wenn CCcam Proxies vorhanden sind oder ein CCcam Server verwendet wird.

Einstellung für CCcam-Ignore-Reshare = -1|0|1

cccignorereshare = -1 # benutze den ignorereshare-level der oscam.conf [ccc] - default
= 0 # benutze den ignorereshare-level des Servers
= 1 # benutze den ignorereshare-level des Readers oder Users

===== cccstealth =====
{{Depends}}
cccstealth = -1|0|1

-1 = benutze CCcam-stealth der oscam.conf [ccc] - default
0 = benutze das extendet OSCam-CCcam-Protokoll
1 = verhält sich ähnlich wie das original CCcam-Protokoll, es werden keine aktiven Partner dargestellt.
Andere OScam's werden davor geschützt, dass der Server als OSCam-Server erkannt wird.

{{OSCamTranslatedLinks}}

OSCam/fr/Config/oscam.user

2017-02-09T17:05:38Z

Pr2: /* allowedtimeframe */ Mentionne les nouvelles possibilités étendues

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

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Le contenu du Wiki français est encore partiellement en Allemand. Enregistres-toi pour nous aider à compléter et traduire les articles.

== oscam.user ==
Ce fichier contient les paramètres des comptes utilisateur(s). Chaque section [account] correspond à un compte utilisateur.

=== Account ===
{{OSCamUserParameter}}

==== user ====
{{ Obligatoire}}

Nom d'utilisateur ou login du client

user = # Pas de nom d'utiisateur (par defaut)
user = user1 # Affectation du nom de l'utilisateur

==== pwd ====
{{Obligatoire}}

Mot de passe de l'utilisateur ou client.

pwd = # Pas de mot de passe (par défaut)
pwd = pwuser1 # Attribution d'un mot de passe

==== description ====
{{Pasindispensable}}

On peut donner ici une description de l'utilisateur

Exemple :

description = toto

==== disabled ====
{{Pasindispensable}}

Ce paramètre permet d'activer ou désactiver un compte utilisateur.

Exemple:
disabled = 0 # (Le compte est activé)
disabled = 1 # (Le compte est désactivé)

Par défaut:
disabled = 0

==== hostname ====
{{Pasindispensable}}

Nom de l'hôte

hostname = # Pas de nom d'hôte (par défaut)
hostname = user1.dyndns.org # Affectation à un nom d'hôte

==== expdate ====
{{Pasindispensable}}

Ce paramètre permet de définir une date d'expiration pour un compte utilisateur.

Exemple:
expdate = 2099-12-31 # (jusqu'au 31.12.2099)
expdate = <year>-<month>-<day>|<year>/<month>/<day>

Par défaut:
expdate =

==== allowedprotocols ====
{{Pasindispensable}}

NOUVEAU svn 5662:07/2011

allowedprotocols = protocole 1,protocole 2,protocole 3,...
vous pouvez spécifier ici le(s) protocole(s) accepté(s) pour l'utilisateur

Liste des protocoles possibles :

camd33
camd35
cs357x
cs378x
newcamd
cccam
gbox
radegast

Exemple:
allowedprotocols = # Tous les protocoles possibles sont autorisés (par défaut)
= cs357x,gbox # L'utilisateur est autorisé uniquement à utiliser les
protocoles gbox et cs357x pour accéder au serveur

==== allowedtimeframe ====
{{Pasindispensable}}

Ce paramètre permet de définir la tranche horaire pendant laquelle l'utilisateur peut visionner les programmes auxquels il a accès ainsi que le(s) jour(s).

Format:
DAY@HH:MM-HH:MM[,HH:MM-HH:MM][,HH:MM-HH:MM][;DAY@HH:MM-HH:MM[,HH:MM-HH:MM][,HH:MM-HH:MM]]
où DAY=SUN,MON,TUE,WED,THU,FRI,SAT ou ALL (pour tous les jours).

une virgule (,) pour séparer les plages horaires et un point-virgule (;) pour séparer les différents jours.
Vous pouvez utiliser ALL@ si vous voulez les mêmes plages horaires tous les jours.

Exemple:
allowedtimeframe = ALL@10:00-22:00;MON@00:00-02:00,02:45-04:37;FRI@00:00-10:00,22:00-24:00;SAT@00:00-24:00

Si vous utilisez: DAY@22:00-05:00 cela sera converti en DAY@00:00-05:00,22:00-24:00 
ALL@ est toujours utilisé et testé, donc dans l'exemple vous pouvez regarder la télévision tout la journée le vendredi (FRI@). Il n'y a aucun problème de superposer une plage horaire dans ALL@ , comme par exemple pour la définition de samedi (SAT@).

Par défaut:
allowedtimeframe =

==== uniq ====
{{Pasindispensable}}

Le paramètre "uniq" détermine le nombre de connexions simultanées autorisées pour un client.

uniq = 0 # Désactivé (par defaut)
uniq = 1 # La première connexion est autorisée
uniq = 2 # Mets l'utilisateur en FAKE si ses adresses IP sont différentes
uniq = 3 # Une seule connexion par utilisateur. Uniquement la dernière connexion est gardée
uniq = 4 # Mets l'utilisateur en FAKE si ses adresses IP sont différentes.
Uniquement la dernière connection reste intacte

==== numusers ====
{{Version}}

Nombre d'utilisateurs pris en compte pour le calcul des ECMs (si anticasc est activé dans oscam.conf) 
Si absent c'est la valeur de numusers dans oscam.conf qui est prise en compte

numusers = # Utilisation de la valeur de numusers définie dans oscam.conf (valeur par défaut)
numusers = 0 # Anticascading désactivé
= 1 # Un utilisateur ==> (1*100+80)/(10*100/60) = 11 ecms au total par minute
= 2 # Deux utilisateurs ==> (2*100+80)/(10*100/60) = 17 ecms au total par minute 
10 = chiffre mis dans oscam.ac. Par defaut c'est 10

==== penalty ====
{{Version}}
Sanction pour l'utilisateur en faute 
Si absent c'est la valeur de penalty dans oscam.conf qui est prise en compte 
(ne doit pas être inférieur à 0 sinon Oscam lui donne la valeur 0)

'''penalty = ''' # Utilisation de la valeur de [[OSCam/fr/Config/oscam.conf#penalty|penalty]] définie dans oscam.conf ('''défaut''')
penalty = 0 # Uniquement loging
penalty = 1 # Des Faux DW's sont envoyés
penalty = 2 # L'utilisateur est temporairement banni
penalty = 3 # Des vrais DW's sont envoyés mais avec un délai ([[OSCam/fr/Config/oscam.conf#fakedelay|fakedelay]])

==== fakedelay ====
{{Pasindispensable}}
NOUVEAU svn7785:10/22/2012

fakedelay = Millisekunden oder 0|-1

setzt die fakedelay-time individuell für den User

0 = fakedelay disabled
-1 = fakedelay aus der oscam.conf[global] verwenden (default)
= Wert für den User in Millisekunden

==== failban ====
{{Pasindispensable}}
MODIFICATIONS svn 7772:10/21/2012

Permet de bloquer une adresse IP

Exemple:
failban = 0 # Ignoré (par défaut)
failban = 2 # Bloque l'adresse IP, si un client désactivé se connecte
failban = 4 # Bloque l'adresse IP d'un compte utilisateur dormant
failban = 8 # Bloque l'adresse IP duplicate
 
 
==== acosc_max_active_sids ====
{{Pasindispensable}}
 
NOUVEAU svn 7940:05/20/2014 

acosc_max_active_sids = Anzahl

Maximale Zahl activer SIDs mit anti-cascading über SID
 
0 = unbegrenzt, default
-1 = benutze die Einstellungen aus oscam.conf [global]
 
 

==== acosc_zap_limit ====
{{Pasindispensable}}
 
NOUVEAU svn 7940:05/20/2014

acosc_zap_limit = Anzahl
 
Zap-Limit für anti-cascading über SID
 
0 = unbegrenzt, default
-1 = benutze die Einstellungen aus oscam.conf. [global]
 
 
==== acosc_penalty ====
{{Pasindispensable}}
 
NOUVEAU svn 7940:05/20/2014

acosc_penalty = 0|1|2|3|-1
 
Penalty-Level für anti-cascading über SID
 
0 = nur loggen, default
1 = sende fake CW's
2 = vorübergehendes Bannen des Users
3 = sende verzögerte CW's
-1 = benutze die Einstellungen aus oscam.conf [global]
 
 
==== acosc_penalty_duration ====
{{Pasindispensable}}
 
NOUVEAU svn 7940:05/20/2014

acosc_penalty_duration = Sekunden
 
Dauer der acosc_penalty für anti-cascading über SID
 
0 = keine, default
-1 = benutze die Einstellungen aus Oscam.conf [global]
 
 
==== acosc_delay ====
{{Pasindispensable}}
 
NOUVEA svn 7940:05/20/2014

acosc_delay = Millisekunden
 
Dauer des delay für anti-cascading über SID
 
0 = kein, default
-1 = benutze die Einstellungen aus Oscam.conf [global]
 
 

==== lb_nbest_readers ====
{{Pasindispensable}}
NOUVEAU svn8642:05/10/2013

lb_nbest_readers = count

set count of best readers for load balancing

-1 = use global lb_nbest_readers in oscam.conf
1 = default

==== lb_nbest_percaid ====
{{Pasindispensable}}
NOUVEAU svn8642:05/10/2013

lb_nbest_percaid = CAID1:count1[,CAID2:count2]...

set count of best readers per CAIDs for load balancing, wildcards CAIDs with two-digit CAIDs possible.
default = none

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

==== preferlocalcards ====
{{Pasindispensable}}

NOUVEAU svn 10050:11/30/2014

preferlocalcards = 0|-1|1|2

-1 = es werden die Werte aus oscam.conf[global] verwendet (default)
0 = lokale Karten werden wie ein remote Reader verwendet
1 = verwende cache exchange basierte Karten
2 = verwende lokale Karten

==== cwc_disable ====
{{Pasindispensable}}
NOUVEAU svn 10049:11/30/2014

cwc_disable = 0|1

1 = disable cw cycle check
0 = default

==== cacheex ====
{{Pasindispensable}}
NOUVEAU svn6039:11/26/2011

C'est pour échanger le cache d'OSCam.

1 = échange du cache activé pull mode
2 = échange du cache activé push mode
3 = échange du cache activé reversepush mode
0 = par défaut

- Uniquement valable entre 2 ou plusieurs OSCam;
- Devrait fonctionner avec tous les protocoles supportant les ECMs multiples ex: camd35 ou CCcam.

===== cacheex-modes =====
===== cacheex = 1 - cachepull =====
Situation:

OSCam A reader1 est réglé sur cacheex = 1

OSCam B account1 est réglé sur cacheex = 1

OSCam A reçoit une demande ECM, reader1 envoie cette demande à OSCam B,

OSCam B vérifie son cache:
* rien dans le cache n'est trouvé: OSCam B envoie: NOK
* quelque chose dans le cache est trouvé; OSCam B envoie: OK+CW
* quand rien dans le cache n'est trouvé, il est noté une demande en attente: ''cacheexwaittime'' dans oscam.conf [global] est attendu et puis re-examinée. OSCam B ne demande plus de nouvelles EMMs.

CW-flow = B ---> A

===== cacheex = 2 - cachepush =====
Pour les protocoles camd 3.5x et CCcam

Situation:

OSCam A reader1 est réglé sur cacheex = 2

OSCam B account1 est réglé sur cacheex = 2

Quand Oscam B reçoit un CW, il est poussé sur Oscam A. Le reader a des fonctions normales et peut demander des ECM.
* Problème: OSCAM ne peut pas pousser les CW sur Oscam A, s'il est connecté à Oscam A
* Fonctionnalité ou problème?: OSCam A peut demander des ECM à OSCam B

CW-flow = B ---> A

===== cacheex = 3 - reversecachepush =====
Pour les protocoles camd 3.5x et CCcam

Situation:

OSCam A reader 1 est réglé sur cacheex = 3

Quand OSCam A reçoit un CW, il est poussé à Oscam B. OSCam A ne demande plus de nouvel ECM

CW-flow = A ---> B

==== cacheex_maxhop ====
{{Pasindispensable}}
NOUVEAU svn6691:05/07/2012

cacheex_maxhop = n

Par défaut = 10

==== sleep ====
{{Pasindispensable}}

Temps en minutes. Une fois écoulé, l'utilisateur est mis en état "inactif" (à condition que sleepsend soit à 255 sinon aucun effet).
Vous pouvez définir une valeur par défaut globale en utilisant la commande sleep au niveau du oscam.conf.
Si l'utilisateur reste en permanence sur la même chaîne sans zapper ce paramètre le considére comme inactif et coupe donc la connexion, il ne faut par conséquent pas mettre une valeur trop petite!

sleep = # Aucun décompte (par défaut)
sleep = 5 # Décompte de 5 minutes

==== sleepsend ====
{{Pasindispensable}}

Activation de la mise en sommeil des requêtes clients, cette commande doit être couplée avec le paramètre sleep (soit au niveau global dans votre oscam.conf, soit au niveau du user dans votre oscam.user).

sleepsend = # La fonction n'est pas active (Par défaut)
sleepsend = 255 # Clients Camd 3.x: Arrêt des requêtes jusqu'au redémarrage du Camd 3.x.
# Clients OSCam: Arrêt des requêtes jusqu'au changement de la chaîne.

==== suppresscmd08 ====
{{Pasindispensable}}

[global]
suppresscmd08 = 0|1
Dire aux clients camd 3.5x, 3.57x et 3.78x de ne pas faire à nouveau des demandes pour les CAID, ServiceID et providerID qui sont déjà rejetés. 1 = désactivé, défaut = 0

[cs378x]
suppresscmd08 = 0|1
Dire aux clients 3.78x de ne pas faire à nouveau des demandes pour les CAID, ServiceID et providerID qui sont déjà rejetés. 1 = désactivé, défaut = 0

[cs357x]
suppresscmd08 = 0|1
Dire aux clients 3.57x de ne pas faire à nouveau des demandes pour les CAID, ServiceID et providerID qui sont déjà rejetés. 1 = désactivé, défaut = 0

Exemple:
suppresscmd08 = 0 # (activeé)
suppresscmd08 = 1 # (deactiveé)

Par défaut:
suppresscmd08 = 0

==== keepalive ====
{{Pasindispensable}}

Ce paramètre est utilisé pour maintenir la connexion client /newcamd-serveur active

Exemple:
keepalive = 0 # (Désactivé)
keepalive = 1 # (Activé)

Par défaut:
keepalive = 1

==== umaxidle ====
{{Pasindispensable}}

NOUVEAU svn8929:09/25/2013

MODIFICATIONS svn 9801:07/17/2014

umaxidle = secondes

Valeur en secondes avant déconnexion de l'utilisateur inactif.

-1 = Valeur dans ''clientmaxidle'' de la section [global]
0 = Pas de déconnexion de l'utilisateur inactif (default)
x = Valeur en secondes

==== caid ====
{{Pasindispensable}}

caid = <CAID>[&<mask>][:<target CAID>][,<CAID>[&<mask>][:target <CAID>]]...

Définition et "mapping" des CAIDs pour les "reader". Par défaut:tous les CAIDs avec masque FFFF

Exemples:

caid = 0100
caid = 0200 & ffee: 0300
caid = 0400 & ff00: 0500.0600
caid = 0702.0722
caid = 0702 & FFDF (raccourci pour l'exemple ci-dessus)
défaut: tous les CAID avec le masque de FFFF

==== au ====
{{Pasindispensable}}

Avec le paramètre 'au' un client peut envoyer des EMM (mise à jour des droits) à un ou plusieurs readers définis (1 = à tous les readers)

au = # Pas de mise à jour automatique des droits (par défaut)
au = 1 # Mise à jour des droits pour tous les readers
au = label_of_reader # Mise à jour des droits pour le reader configuré dans oscam.server
au = label_of_reader,label_of_reader # Mise à jour des droits pour plusieurs readers
( A partir de la version >= #4617 )

==== group ====
{{Obligatoire}}
MODIFICATIONS svn6103:12/21/2011

Chaque utilisateur doit appartenir à un ou plusieurs groupes. Avec ce paramètre, on détermine à quels readers (définis dans [[OSCam/fr/Config/oscam.server|'''oscam.server''']]) le client peut avoir accès. Max 64 groupes

group = 1....64[,1....64]....
default = blanc

group = # L'utilisateur ne fait partie d'aucun groupe (pas de décodage possible)
group = 1 # L'utilisateur fait partie du groupe 1
group = 1,2 # L'utilisateur fait partie des groupes 1 et 2

==== betatunnel ====
{{Version}}

'''pour SKY HD (de)'''

Der Betatunnel dient zum Mappen (Umhängen) von Sky- und KD-CAIDs, sodass z.B. 1833'er-Anfragen über 1702 beantwortet werden können.
Notwendig ist dieses Mapping eigentlich nur bei HD-Kanälen, aber es lassen sich auch alle anderen Kanäle damit "umhängen".

[[Datei:MessageS.png|text-bottom]] '''Vor- und Nachteile eines kompletten und eines aufgeschlüsselten Mappings:'''
* Bei einem '''kompletten Mapping''' "''1833.FFFF:1702''" werden alle SIDs (Programme) übersetzt. Dies hat den '''Vorteil''', dass der Client auch bei nicht HD-Sendern sofort beantwortet wird und keinen weiteren Server anfragen muss. '''Nachteil''', ein komplettes Mapping ist nicht so schnell wie ein aufgeschlüsseltes und die Anfragen benötigen 100-200ms mehr.
* Ein '''aufgeschlüsseltes Mapping''' hat "nur" den '''Vorteil''', dass die Anfrage schneller beantwortet werden kann. '''Nachteil''', Du setzt eine "beschnittene" Karte ins Share, die nur die im Betatunnel definierten Programme umhängt, obwohl sie ggf. "mehr" kann.

Die Meinungen, was ist besser und was nicht, unterscheiden sich sehr. Entscheide selbst, was das Beste für dich ist.

[[Datei:WarningS.png|text-bottom]] '''Achtung:'''
* Wenn Du einen Betatunnel einsetzt, musst Du auch die ''oscam.services'' anpassen, z.B. ''caid=1702,1833'' für SAT.
* Ab OSCam Revision #4347 sind maximal 20 Mappings möglich, bei vorigen Versionen nur 16.

[[Datei:MessageS.png|text-bottom]] '''Weitere Informationen:'''
* Es tut nicht weh, den Betatunnel bei allen Usern einzusetzen, wenn Du eine davon betroffene Karte besitzt.
* CCcam-Clients tunneln 1833 von Haus aus (nicht 1834!), sprich hier wäre es nicht nötig, aber es tut auch hier nicht weh.
* Setze ggf. auch Prioritäten Deiner Clients, z.B. ''1702'' vor ''1833''.

Beispiele:
# betatunnel = <CAID>.<ServiceID>:<target CAID>
#
# Sky, Mapping aller 1833'er-Anfragen auf CAID 1702...
betatunnel = 1833.FFFF:1702
#
# KD, Mapping aller 1834'er-Anfragen auf CAID 1722...
betatunnel = 1834.FFFF:1722
#
# Sky, es werden NUR die HD-Kanäle gemapped...
betatunnel = 1833.0082:1702,1833.006F:1702,1833.0077:1702,1833.0084:1702,1833.0071:1702,1833.0070:1702,1833.0075:1702,1833.006A:1702,1833.006B:1702,1833.007C:1702,1833.0081:1702,1833.0072:1702

Default:
betatunnel =
 

==== emmreassembly ====
{{Pasindispensable}}

NOUVEAU svn8591:04/01/2013

emmreassembly = 0|1|2

0 = Assemblage des EMM Désactivé
1 = Assemblage des EMM '''pour DVB API''' Activé
2 = Assemblage des EMM Activé (default)

Uniquement pour les readers '''Viaccess et Cryptoworks''', quand les clients sont sollicités pour l'envoi des EMM, un regroupement est fait pour ensuite être envoyé au reader concerné.

 

==== services ====
{{Pasindispensable}}

Ce paramètre permet de spécifier quels sont les services que peut utiliser un utilisateur. Cela nécessite la présence du fichier oscam.services dans le répertoire de votre box etc/tuxbox/config/ (valable pour Enigma2).

La logique ici est la suivante (dans l'ordre):
* Si le champ est vide (ou invalide), la requête est autorisée.
* Quand un service négatif (çàd ceux avec '''!''') Est applicable, la demande est rejetée.
* Si un service positif est applicable ou il existe aucun service positif, la demande est autorisée.
* Si aucun des points précédents, la demande est rejetée.
Cela signifie que les services négatifs ne sont nécessaires que dans des cas particuliers.
A savoir, si vous avez un service positif mais que l'on veut exclure certains srvid.
Ce n'est pas recommandé, car des erreurs de configuration apparaissent rapidement.
Au lieu de cela, il vaut mieux créer un service supplémentaire contenant tous les srvid appropriés.

services = # Tous les services sont autorisés (par défaut)
services = '''service1''',!'''service2''' # '''service1''' est autorisé, '''service2''' est refusé
services = !'''service3''' # Tous les '''service3''' sont refusés

==== ident ====
{{Pasindispensable}}

ident = <CAID>:<ident>[,<ident>,...][;<CAID>:<ident>[,<ident>,...]]...

Assignation d'utilisateur(s) à un IDENT spécifique de la carte d'abonnement.

default:none

==== class ====
{{Pasindispensable}}

class = [!]class[,[!]class]...

Assignation d'utilisateur(s) à des classes spécifiques de la carte d'abonnement.

Par défaut=aucun

Example:
class = 01,02,!03,!04

==== chid ====
{{Pasindispensable}}

chid = <CAID>:<ChID>[,<CAID>:<ChID>]...

Assignation d'utilisateur(s) à un ou plusieurs ChIDs (Channel IDs - IDentificateur de programme(s))

Par défaut:aucun

= [vide] par défaut

==== monlevel ====
{{Pasindispensable}}

Spécifie le niveau de monitoring du client. Le moniteur est configuré dans le ficier '''oscam.conf''' dans la section [monitor]

Exemple:
monlevel = 0 # (Aucun accès au moniteur)
monlevel = 1 # (Seulement le serveur et le processus en cours)
monlevel = 2 # (Tous les processus en lecture seulement)
monlevel = 3 # (Tous les processus et "le rechargement de oscam.user ?")
monlevel = 4 # (Accès complet)

Par défaut:
monlevel = 2

==== ccc ====

===== cccmaxhops =====
{{Version}}

Seulement si des serveurs utilisant le protocole CCcam sont disponibles ou un serveur CCcam est utilisé.

Permet de définir le nombre maximal de sauts (hops) pour l'utilisateur.

Exemple:
cccmaxhops = -1 # no CCcam pour l'utilisateur
0 # local + 0 hop
1 # local + 1 hop
x # local + nombre de hops

Par défaut:
cccmaxhops = 10 # local + 10 hops

===== cccreshare =====
{{Version}}

MODIFICATIONS svn8608:04/10/2013

Niveau Reshare pour un client utilisant le protocole CCcam

cccreshare = -1 # utilisation du niveau [[OSCam/fr/Config/oscam.conf#reshare|reshare]] défini dans oscam.conf - defaut
= 0 # repartage pour les clients directs uniquement.
= x # repartage pour les clients directs et x niveau(s) supplémentaire(s) (x correspond au nombre de niveau)

Reshare peut être défini de 2 façons:

* Dans oscam.server [lecteur] ("cccreshare")
* Dans oscam.user [compte] ["cccreshare")

La valeur de Reshare correspond à la plus petite valeur des 2 paramètres !

===== cccignorereshare =====
{{Version}}

Seulement si des proxies CCcam ou serveurs CCcam sont utilisés !

cccignorereshare = -1|0|1

cccignorereshare = -1 # utilisation d'ignorereshare défini dans oscam.conf [ccc]
default = 0 # utilise le paramètre de repartage du serveur
= 1 # utilise le paramètre de repartage du lecteur ou utilisateur

===== cccstealth =====
{{Version}}

cccstealth = -1|0|1

Sert pour le camouflage:

cccstealth = -1 ( par défaut ) c'est à dire OSCam tiendra compte de la configuration du paramètre stealth dans [cccam] du fichier oscam.conf
= 0 camouflage désactivé, les utilisateurs OSCam pourront découvrir que nous utilisons OSCam-CCcam.
= 1 camouflage activé, se comporte comme un CCcam original.

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.user

2017-02-09T16:59:27Z

Pr2: /* allowedtimeframe */ Detail the new extended timeframes possibilities

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

== oscam.user ==
The user configuration file for OSCam contains user definitions. [account] sections in oscam.user are recurring (more than one account).

=== [account] ===
{{OSCamUserParameter}}

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

account name

Example:
user = user1

Default:
user =

==== pwd ====
{{required}}

password for account

Example:
pwd = pwuser1

Default:
pwd =

==== description ====
{{Optional/en}}
description of user account (text)

Описание аккаунта пользователя (текст)

==== disabled ====
{{Optional/en}}

account disabled

Beispiel:
disabled = 0 # (account enabled)
disabled = 1 # (account disabled)

Default:
disabled = 0

==== hostname ====
{{Optional/en}}
host from which user connection is allowed

Example:
hostname = client.dyndns.org

Default:
hostname =

==== expdate ====
{{Optional/en}}

expiration date for account

Format:
<year>-<month>-<day>|<year>/<month>/<day>

Example:
expdate = 2001-11-21
expdate = 2002/12/22

Default:
expdate = none

==== allowedprotocols ====
{{Optional/en}}

allowedprotocols = [protocol1][,][protocol2][,][protocol3][,]...

allowed protocols for user

protocols
camd33
camd35
cs357x
cs378x
newcamd
cccam
gbox
radegast

example
allowedprotocols = cs357x,gbox # only cs357x and gbox protocols are allowed
= [blank] # all protocols are allowed (default)

==== allowedtimeframe ====
{{Optional/en}}

account enabled from - to for specified day(s)

Format:
DAY@HH:MM-HH:MM[,HH:MM-HH:MM][,HH:MM-HH:MM][;DAY@HH:MM-HH:MM[,HH:MM-HH:MM][,HH:MM-HH:MM]]
where DAY=SUN,MON,TUE,WED,THU,FRI,SAT or ALL (for all possible days)

comma (,) to separate times and semicolon(;) to separate the different days.
You can use ALL@ if you want the same time frames for everyday.

Example:
allowedtimeframe = ALL@10:00-22:00;MON@00:00-02:00,02:45-04:37;FRI@00:00-10:00,22:00-24:00;SAT@00:00-24:00

If you use: XXX@22:00-05:00 this will be turned into XXX@00:00-05:00,22:00-24:00 
ALL@ is always checked and used, so you can watch TV the whole day on FRIday in this exemple. There is no problem to overlap ALL@ in a day definition, like for SAT@ definition.

Default:
allowedtimeframe =

==== uniq ====
{{Optional/en}}

Example:
uniq = 0 # disabled, default
uniq = 1 # only one connection per user is allowed
uniq = 2 # set user to fake if source ip is different
(e.g. for newcamd clients with different CAIDs and ports)
uniq = 3 # only one connection per user, but only the last login will survive (old mpcs behavior)
uniq = 4 # set user only to fake if source ip is different, but only the last login will survive

Default:
uniq = 0

==== numusers ====
{{Depends/en}}

used only '''if anticascading''' is enabled!

numusers = # quantity

user per account

Example:
numusers = -1 # (global value from oscam.conf, default)
numusers = 5 # (maximal 5 user)
numusers = 0 # (anticascading disabled)

==== penalty ====
{{Depends/en}}

used only if '''anticascading''' is enabled!

level of penalty:
'''penalty = -1''' # use value of [[OSCam/en/Config/oscam.conf#penalty|penalty]] defined in oscam.conf ('''default''')
penalty = 0 # only logging
penalty = 1 # send fake DWs
penalty = 2 # ban user temporary
penalty = 3 # send DWs with delay ([[OSCam/en/Config/oscam.conf#fakedelay|fakedelay]])

==== fakedelay ====
{{Optional/en}}
NEW svn7785:10/22/2012

fakedelay = milli seconds or 0|-1

se fake delay time individually for user

0 = fake delay disabled
-1 = fake delay of oscam.conf[global] (default)
= fake delay in milli seconds for user

==== failban ====
{{Optional}}

CHANGE svn 7772:10/21/2012

mask for IP based blocking:

failban = 0|2|4|8

failban = 0 # ignore (default)
failban = 2 # block IP address of a disabled account on connecting
failban = 4 # block IP address of a sleeping account while sleeping comes up
failban = 8 # block duplicate IP address
 
 

==== acosc_max_active_sids ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014 

acosc_max_active_sids = count

maximum active SIDs with anti-cascading over SID
 
0 = unlimited, default
-1 = use global setting from oscam.conf [global]
 
 

==== acosc_zap_limit ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_zap_limit = count
 
zap-limit for anticascading over SID
 
0 = unlimited, default
-1 = use global setting from oscam.conf.[global]
 
 
==== acosc_penalty ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_penalty = 0|1|2|3|-1
 
level of penalty with anti-cascading over SID
 
0 = only logging, default
1 = send fake CW's
2 = temporary user ban
3 = send delayed CW's
-1 = use global setting from oscam.conf [global]
 
 
==== acosc_penalty_duration ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_penalty_duration = seconds
 
penalty duration for anti-cascading over SID
 
0 = mone, default
-1 = use global setting from oscam.conf[global]
 
 
==== acosc_delay ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_delay = milli-seconds
 
Dauer des delay für anti-cascading über SID
 
0 = none, default
-1 = use global setting Oscam.conf[global]
 
 

==== lb_nbest_readers ====
{{Optional/en}}
NEW svn8642:05/10/2013

lb_nbest_readers = count

set count of best readers for load balancing

-1 = use global lb_nbest_readers in oscam.conf
1 = default

==== lb_nbest_percaid ====
{{Optional/en}}
NEW svn8642:05/10/2013

lb_nbest_percaid = CAID1:count1[,CAID2:count2]...

set count of best readers per CAIDs for load balancing, wildcards CAIDs with two-digit CAIDs possible.
default = none

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

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

NEW svn 10050:11/30/2014

preferlocalcards = 0|-1|1|2

-1 = global value from oscam.sonf[global] (default)
0 = local SCs used like a remote reader
1 = prefer call exchange based SCs
2 = prefer local SCs

==== cwc_disable ====
{{Optional/en}}
NEW svn 10049:11/30/2014

cwc_disable = 0|1

1 = disable cw cycle check
0 = default

==== cacheex ====
{{Optional/en}}
NEW svn6039:11/26/2011

cacheex = 0|1|2|3

1 = enable cache exchange pull mode
2 = enable cache exchange push mode
3 = enable cache exchange reversepush mode
0 = default
for camd 3.5x and CCcam protocol

see also on oscam.server!

Identical cache exchange modes must be set on local OSCam user account and remote OSCam server!

===== cacheex-modes =====
===== cacheex = 1 - cachepull =====
Situation:

OSCam A reader1 has cacheex = 1

OSCam B account1 has cacheex = 1

OSCam A gets a ECM request, reader1 send this request to OSCam B,

OSCam B checks his cache:
* Not found in cache: return NOK
* Found in cache: return OK+CW
* Not found in cache, but found pending request: wait ''cacheexwaittime'' in oscam.conf [global] and check again. OSCam B never requests new ECMs.

CW-flow = B ---> A

===== cacheex = 2 - cachepush =====
Situation:

OSCam A reader1 has cacheex = 2

OSCam B account1 hastcacheex = 2

If OSCam B gets a CW, its pushed to OSCam A, reader has normal functionality and can request ECMs.
* Problem: OSCAM can only push CW's if OSCam A is connected
* Problem or feature?: OSCam A reader can request ECMs from OSCam B

CW-flow = B ---> A

===== cacheex = 3 - reversecachepush =====
Situation:

OSCam A reader 1 has cacheex = 3

If OSCam A gets a CW, its pushed to OSCam B. OSCam A never requests new ECMs.

CW-flow = A ---> B

==== cacheex_maxhop ====
{{Optional/en}}
NEW svn6691:05/07/2012

cacheex_maxhop = hops
= defaolt = 10 hops

define maximum hops for cache exchange

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

time waiting for inactive user in minutes

Example:
sleep = 5

Default:
sleep =

==== sleepsend ====
{{Optional/en}}
0|255

255 = '''OSCam client''' only: stopping requests until next zap,

255 = '''camd 3.x''' only: stopping requests until restart of camd3 client

Examples:
sleepsend = 0
sleepsend = 255

Default:
sleepsend =

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

switches suppress of CMD08

suppresscmd08 = 0 # CMD08 for camd3 3.57x/3.78x clients '''enabled'''
suppresscmd08 = 1 # CMD08 for camd3 3.57x/3.78x clients '''disabled'''

Default:
suppresscmd08 = 0

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

disable keepalive between newcamd-server and client connection

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

==== umaxidle ====
{{Optional/en}}

NEW svn8929:09/25/2013

CHANGE svn 9801:07/17/2014

umaxidle = seconds

value for user being idle before disconnect.

-1 = use clientmaxidle in [global]-section
0 = idle disconnect disabled (default)

==== caid ====
{{Optional/en}}

caid = <CAID>[&<mask>][:<target CAID>][,<CAID>[&<mask>][:target <CAID>]]...

define and mapping of CAIDs for reader, default:all CAIDs with mask FFFF

example:
caid = 0100
caid = 0200&ffee:0300
caid = 0400&ff00:0500,0600
caid = 0702,0722
caid = 0702&ffdf (shortcut for the example above)

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

Format:
label of reader[,label of reader]...|1

AU settings:
au = [label of reader] # sending EMMs to specified reader
(security issue: clients can see SC data!)
au = 1 # auto AU is sending EMMs to all readers
(security issue: clients can see SC data!)
Default:
au = [blank] # none

Sometimes only global emm's update '''same caid cards''':

- check if you blocked unique/shared in READER Blockemm

- don't use au = 1, use au = [label of reader]

- if still troublesome use '''in house''' different user to update each card by [label of reader]

example: cd__nl and tv__vl have a common provider: m7 group sa and share updates on shared channels.

user 1: AU: cd__nl,sky_uk

user 2: AU: tv__vl

==== group ====
{{required}}
CHANGE svn6103:12/21/2011

user assingment to reader group. Valid 64 groups

Format:
group = 1....64[,1....64]....
default = none

==== betatunnel ====
{{Optional/en}}

define Betacrypt tunneling (max. see CS_MAXTUNTAB in globals.h). The ServiceID can also be used for wildcarded CAIDs.

Format:
<CAID>.<ServiceID>:<target CAID>[,<CAID>.<ServiceID>: <target CAID>]...

Example:
betatunnel = 0100.0001:0200,0300.0004:0500
betatunnel = 0600.FFFF:0700

Default:
betatunnel =
 

==== emmreassembly ====
{{Optional/en}}

NEW svn8591:01/04/2013

emmreassembly = 0|1||2

EMM reassembly, should be set for Viaccess and Cryptoworks readers if the client that you are using to send EMMs is reassembling them instead of just sending them to OSCam for processing.

0: disabled
1: enabled for DVB API
2: enabled (default)

==== services ====
{{Optional/en}}

What services may use the User.? This requires a oscam.services be present. The logic here is as follows (in this order):
* If the field is empty (or invalid), the request is allowed.
* When a negative service (ie, those with '''!''') is applicable, the request is rejected.
* If a positive service is applicable or there is no positive service, the request is allowed.
* If none of the previous points, the request is rejected.
This means that negative Services are only necessary in individual cases. Namely, exactly, then if you have a positive service, but it wants to exclude some back. This is not recommended, because here comes quickly to misconfigurations. Instead, an additional service to be created that contains all the relevant channels.

Example:
services = service1,!service2 # (client may receive service1, but not service2)
services = [!]services

Default:
services =

==== ident ====
{{Optional/en}}

user assingment to SC specific idents

Format:
<CAID>:<ident>[,<ident>,...][;<CAID>:<ident>[,<ident>,...]]...

default = none

==== class ====
{{Optional/en}}

user [de]assingment to SC specific classes

Format:
[!]class[,[!]class]...

Example:
class = 01,02,!03,!04

default = none

==== chid ====
{{Optional/en}}

user assingment to SC specific ChID

Format:
chid = <CAID>:<ChID>[,<ChID>,...][;<CAID>:<ChID>[,<ChID>,...]]...
= [blank] default

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

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

==== ccc ====

===== cccmaxhops =====
{{Depends/en}}
only if '''CCcam proxies or CCcam server''' are used!

maximum hops limit for CCcam clients

cccmaxhops = -1 # CCcam disbled for this user
0 # local SCs only
1 # local SCs + 1 hop
2 # local SCs + 2 hops
# and so on

Default:
cccmaxhops = 10 # local SC's + 10 hops

===== cccreshare =====
{{Depends/en}}

CHANGE svn8608:04/10/2013

reshare level for CCcam clients

Example:
cccreshare = -1 # use [[OSCam/en/Config/oscam.conf#reshare|reshare]] level defined in oscam.conf - default
= 0 # reshare for direct peer only
= 1 # resharing for direct peer and next level

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 !

===== cccignorereshare =====
{{Depends/en}}

only if '''CCcam proxies or CCcam server''' are used!

CCcam ignore reshare settings

cccignorereshare = -1 # use ignore reshare level of oscam.conf [ccc] - default
= 0 # use ignore reshare level of server
= 1 # use ignore reshare level of reader or user

===== cccstealth =====
{{Depends/en}}

cccstealth = -1|0|1

-1 = # use CCcam stealth of oscam.conf [ccc] - default
0 = # use extendet OSCam-CCcam-protocol
1 = # behaviour like the original CCcam-protocol, no activate partner detection and extendet
OSCam-CCcam-protocol, prevent other OSCam to detect the server as OSCam-server

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.user

2017-02-08T17:00:25Z

Pr2: /* failban */ Add missing u

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

== oscam.user ==
The user configuration file for OSCam contains user definitions. [account] sections in oscam.user are recurring (more than one account).

=== [account] ===
{{OSCamUserParameter}}

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

account name

Example:
user = user1

Default:
user =

==== pwd ====
{{required}}

password for account

Example:
pwd = pwuser1

Default:
pwd =

==== description ====
{{Optional/en}}
description of user account (text)

Описание аккаунта пользователя (текст)

==== disabled ====
{{Optional/en}}

account disabled

Beispiel:
disabled = 0 # (account enabled)
disabled = 1 # (account disabled)

Default:
disabled = 0

==== hostname ====
{{Optional/en}}
host from which user connection is allowed

Example:
hostname = client.dyndns.org

Default:
hostname =

==== expdate ====
{{Optional/en}}

expiration date for account

Format:
<year>-<month>-<day>|<year>/<month>/<day>

Example:
expdate = 2001-11-21
expdate = 2002/12/22

Default:
expdate = none

==== allowedprotocols ====
{{Optional/en}}

allowedprotocols = [protocol1][,][protocol2][,][protocol3][,]...

allowed protocols for user

protocols
camd33
camd35
cs357x
cs378x
newcamd
cccam
gbox
radegast

example
allowedprotocols = cs357x,gbox # only cs357x and gbox protocols are allowed
= [blank] # all protocols are allowed (default)

==== allowedtimeframe ====
{{Optional/en}}

account enabled from - to

Format:
hh:mm-hh:mm

Example:
allowedtimeframe = 10:00-22:00

Default:
allowedtimeframe =

==== uniq ====
{{Optional/en}}

Example:
uniq = 0 # disabled, default
uniq = 1 # only one connection per user is allowed
uniq = 2 # set user to fake if source ip is different
(e.g. for newcamd clients with different CAIDs and ports)
uniq = 3 # only one connection per user, but only the last login will survive (old mpcs behavior)
uniq = 4 # set user only to fake if source ip is different, but only the last login will survive

Default:
uniq = 0

==== numusers ====
{{Depends/en}}

used only '''if anticascading''' is enabled!

numusers = # quantity

user per account

Example:
numusers = -1 # (global value from oscam.conf, default)
numusers = 5 # (maximal 5 user)
numusers = 0 # (anticascading disabled)

==== penalty ====
{{Depends/en}}

used only if '''anticascading''' is enabled!

level of penalty:
'''penalty = -1''' # use value of [[OSCam/en/Config/oscam.conf#penalty|penalty]] defined in oscam.conf ('''default''')
penalty = 0 # only logging
penalty = 1 # send fake DWs
penalty = 2 # ban user temporary
penalty = 3 # send DWs with delay ([[OSCam/en/Config/oscam.conf#fakedelay|fakedelay]])

==== fakedelay ====
{{Optional/en}}
NEW svn7785:10/22/2012

fakedelay = milli seconds or 0|-1

se fake delay time individually for user

0 = fake delay disabled
-1 = fake delay of oscam.conf[global] (default)
= fake delay in milli seconds for user

==== failban ====
{{Optional}}

CHANGE svn 7772:10/21/2012

mask for IP based blocking:

failban = 0|2|4|8

failban = 0 # ignore (default)
failban = 2 # block IP address of a disabled account on connecting
failban = 4 # block IP address of a sleeping account while sleeping comes up
failban = 8 # block duplicate IP address
 
 

==== acosc_max_active_sids ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014 

acosc_max_active_sids = count

maximum active SIDs with anti-cascading over SID
 
0 = unlimited, default
-1 = use global setting from oscam.conf [global]
 
 

==== acosc_zap_limit ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_zap_limit = count
 
zap-limit for anticascading over SID
 
0 = unlimited, default
-1 = use global setting from oscam.conf.[global]
 
 
==== acosc_penalty ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_penalty = 0|1|2|3|-1
 
level of penalty with anti-cascading over SID
 
0 = only logging, default
1 = send fake CW's
2 = temporary user ban
3 = send delayed CW's
-1 = use global setting from oscam.conf [global]
 
 
==== acosc_penalty_duration ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_penalty_duration = seconds
 
penalty duration for anti-cascading over SID
 
0 = mone, default
-1 = use global setting from oscam.conf[global]
 
 
==== acosc_delay ====
{{Optional/en}}
 
NEW svn 7940:05/20/2014

acosc_delay = milli-seconds
 
Dauer des delay für anti-cascading über SID
 
0 = none, default
-1 = use global setting Oscam.conf[global]
 
 

==== lb_nbest_readers ====
{{Optional/en}}
NEW svn8642:05/10/2013

lb_nbest_readers = count

set count of best readers for load balancing

-1 = use global lb_nbest_readers in oscam.conf
1 = default

==== lb_nbest_percaid ====
{{Optional/en}}
NEW svn8642:05/10/2013

lb_nbest_percaid = CAID1:count1[,CAID2:count2]...

set count of best readers per CAIDs for load balancing, wildcards CAIDs with two-digit CAIDs possible.
default = none

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

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

NEW svn 10050:11/30/2014

preferlocalcards = 0|-1|1|2

-1 = global value from oscam.sonf[global] (default)
0 = local SCs used like a remote reader
1 = prefer call exchange based SCs
2 = prefer local SCs

==== cwc_disable ====
{{Optional/en}}
NEW svn 10049:11/30/2014

cwc_disable = 0|1

1 = disable cw cycle check
0 = default

==== cacheex ====
{{Optional/en}}
NEW svn6039:11/26/2011

cacheex = 0|1|2|3

1 = enable cache exchange pull mode
2 = enable cache exchange push mode
3 = enable cache exchange reversepush mode
0 = default
for camd 3.5x and CCcam protocol

see also on oscam.server!

Identical cache exchange modes must be set on local OSCam user account and remote OSCam server!

===== cacheex-modes =====
===== cacheex = 1 - cachepull =====
Situation:

OSCam A reader1 has cacheex = 1

OSCam B account1 has cacheex = 1

OSCam A gets a ECM request, reader1 send this request to OSCam B,

OSCam B checks his cache:
* Not found in cache: return NOK
* Found in cache: return OK+CW
* Not found in cache, but found pending request: wait ''cacheexwaittime'' in oscam.conf [global] and check again. OSCam B never requests new ECMs.

CW-flow = B ---> A

===== cacheex = 2 - cachepush =====
Situation:

OSCam A reader1 has cacheex = 2

OSCam B account1 hastcacheex = 2

If OSCam B gets a CW, its pushed to OSCam A, reader has normal functionality and can request ECMs.
* Problem: OSCAM can only push CW's if OSCam A is connected
* Problem or feature?: OSCam A reader can request ECMs from OSCam B

CW-flow = B ---> A

===== cacheex = 3 - reversecachepush =====
Situation:

OSCam A reader 1 has cacheex = 3

If OSCam A gets a CW, its pushed to OSCam B. OSCam A never requests new ECMs.

CW-flow = A ---> B

==== cacheex_maxhop ====
{{Optional/en}}
NEW svn6691:05/07/2012

cacheex_maxhop = hops
= defaolt = 10 hops

define maximum hops for cache exchange

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

time waiting for inactive user in minutes

Example:
sleep = 5

Default:
sleep =

==== sleepsend ====
{{Optional/en}}
0|255

255 = '''OSCam client''' only: stopping requests until next zap,

255 = '''camd 3.x''' only: stopping requests until restart of camd3 client

Examples:
sleepsend = 0
sleepsend = 255

Default:
sleepsend =

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

switches suppress of CMD08

suppresscmd08 = 0 # CMD08 for camd3 3.57x/3.78x clients '''enabled'''
suppresscmd08 = 1 # CMD08 for camd3 3.57x/3.78x clients '''disabled'''

Default:
suppresscmd08 = 0

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

disable keepalive between newcamd-server and client connection

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

==== umaxidle ====
{{Optional/en}}

NEW svn8929:09/25/2013

CHANGE svn 9801:07/17/2014

umaxidle = seconds

value for user being idle before disconnect.

-1 = use clientmaxidle in [global]-section
0 = idle disconnect disabled (default)

==== caid ====
{{Optional/en}}

caid = <CAID>[&<mask>][:<target CAID>][,<CAID>[&<mask>][:target <CAID>]]...

define and mapping of CAIDs for reader, default:all CAIDs with mask FFFF

example:
caid = 0100
caid = 0200&ffee:0300
caid = 0400&ff00:0500,0600
caid = 0702,0722
caid = 0702&ffdf (shortcut for the example above)

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

Format:
label of reader[,label of reader]...|1

AU settings:
au = [label of reader] # sending EMMs to specified reader
(security issue: clients can see SC data!)
au = 1 # auto AU is sending EMMs to all readers
(security issue: clients can see SC data!)
Default:
au = [blank] # none

Sometimes only global emm's update '''same caid cards''':

- check if you blocked unique/shared in READER Blockemm

- don't use au = 1, use au = [label of reader]

- if still troublesome use '''in house''' different user to update each card by [label of reader]

example: cd__nl and tv__vl have a common provider: m7 group sa and share updates on shared channels.

user 1: AU: cd__nl,sky_uk

user 2: AU: tv__vl

==== group ====
{{required}}
CHANGE svn6103:12/21/2011

user assingment to reader group. Valid 64 groups

Format:
group = 1....64[,1....64]....
default = none

==== betatunnel ====
{{Optional/en}}

define Betacrypt tunneling (max. see CS_MAXTUNTAB in globals.h). The ServiceID can also be used for wildcarded CAIDs.

Format:
<CAID>.<ServiceID>:<target CAID>[,<CAID>.<ServiceID>: <target CAID>]...

Example:
betatunnel = 0100.0001:0200,0300.0004:0500
betatunnel = 0600.FFFF:0700

Default:
betatunnel =
 

==== emmreassembly ====
{{Optional/en}}

NEW svn8591:01/04/2013

emmreassembly = 0|1||2

EMM reassembly, should be set for Viaccess and Cryptoworks readers if the client that you are using to send EMMs is reassembling them instead of just sending them to OSCam for processing.

0: disabled
1: enabled for DVB API
2: enabled (default)

==== services ====
{{Optional/en}}

What services may use the User.? This requires a oscam.services be present. The logic here is as follows (in this order):
* If the field is empty (or invalid), the request is allowed.
* When a negative service (ie, those with '''!''') is applicable, the request is rejected.
* If a positive service is applicable or there is no positive service, the request is allowed.
* If none of the previous points, the request is rejected.
This means that negative Services are only necessary in individual cases. Namely, exactly, then if you have a positive service, but it wants to exclude some back. This is not recommended, because here comes quickly to misconfigurations. Instead, an additional service to be created that contains all the relevant channels.

Example:
services = service1,!service2 # (client may receive service1, but not service2)
services = [!]services

Default:
services =

==== ident ====
{{Optional/en}}

user assingment to SC specific idents

Format:
<CAID>:<ident>[,<ident>,...][;<CAID>:<ident>[,<ident>,...]]...

default = none

==== class ====
{{Optional/en}}

user [de]assingment to SC specific classes

Format:
[!]class[,[!]class]...

Example:
class = 01,02,!03,!04

default = none

==== chid ====
{{Optional/en}}

user assingment to SC specific ChID

Format:
chid = <CAID>:<ChID>[,<ChID>,...][;<CAID>:<ChID>[,<ChID>,...]]...
= [blank] default

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

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

==== ccc ====

===== cccmaxhops =====
{{Depends/en}}
only if '''CCcam proxies or CCcam server''' are used!

maximum hops limit for CCcam clients

cccmaxhops = -1 # CCcam disbled for this user
0 # local SCs only
1 # local SCs + 1 hop
2 # local SCs + 2 hops
# and so on

Default:
cccmaxhops = 10 # local SC's + 10 hops

===== cccreshare =====
{{Depends/en}}

CHANGE svn8608:04/10/2013

reshare level for CCcam clients

Example:
cccreshare = -1 # use [[OSCam/en/Config/oscam.conf#reshare|reshare]] level defined in oscam.conf - default
= 0 # reshare for direct peer only
= 1 # resharing for direct peer and next level

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 !

===== cccignorereshare =====
{{Depends/en}}

only if '''CCcam proxies or CCcam server''' are used!

CCcam ignore reshare settings

cccignorereshare = -1 # use ignore reshare level of oscam.conf [ccc] - default
= 0 # use ignore reshare level of server
= 1 # use ignore reshare level of reader or user

===== cccstealth =====
{{Depends/en}}

cccstealth = -1|0|1

-1 = # use CCcam stealth of oscam.conf [ccc] - default
0 = # use extendet OSCam-CCcam-protocol
1 = # behaviour like the original CCcam-protocol, no activate partner detection and extendet
OSCam-CCcam-protocol, prevent other OSCam to detect the server as OSCam-server

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.server

2017-01-21T18:31:32Z

Pr2: /* ecmunique */ Add: remark about ratelimitecm

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

== oscam.server ==
The server configuration file for OSCam contains reader parameters. Sections in oscam.server are recurring (more than one reader possible). At least one [reader] section is required. Examples for reader configuation you will find here [[OSCam/en/examples/Reader|example configurations]]

{{OSCamServerParameter}}

=== [reader] ===
Define local or remote reader

==== label ====
{{required}}

name for reader

Example:
label = easymouse2

==== enable ====
{{Optional/en}}
deactivate reader
0 = off
1 = On (default)

==== description ====
{{Optional/en}}

description = text

description of reader, default: [blank] none

==== protocol ====
{{required}}

reader protocol
protocol = mouse (local cardreader)
= internal (all cardreader with "device=/dev/sciX", and internal Coolstream-Reader)
= camd35|cs357x (cascading - camd 3.5-compatible remote server - udp)
= mp35
= smartreader
= serial
= cs378x (camd 3.5-compatible remote server - tcp)
= gbox
= newcamd|newcamd525
= newcamd524
= cccam
= radegast
= pcsc
= constcw
= sc8in1
= smargo

==== device ====
{{required}}

CHANGE svn8057+8059:01/04/2013

CHANGE svn8096:01/13/2013

CHANGE svn8911:09/10/2013

define local or remote reader

device = [<readertype>;]serial:serialnum|bus:device|<device|device:slot>|<ip|hostname>,<port>[,<lport>]|pcsc|<0|1>>|constantcw

set reader type

readertype:
SR: Smartreader+ (default)
SRv2: Smartreader V2
Infinity: Infinity USB
TripleP1: Smargo Triple Reader port 1
TripleP2: Smargo Triple Reader port 2
TripleP3: Smargo Triple Reader port 3

bus:device: bus name and device name of the smartreader+
(get the name with lsusb 'Bus' ans 'Device')

serialnum: Serial-Nummer des Smartreader+ or Ininity USB (get the serial number while starting OSCam)

device: device name

device:slot: device name and slot number sc8in1 /1-8)
(only one sc8in1 reader supported)

ip|hostname: IP address or host name

port: TCP/IP port

lport: remapping to local TCP/IP port

PCSC: number of PCSC reader, starting with 0

0|1: ''' for Coolstream HD-1 STB only''': select reader 0 or reader 1

constantcw: constant CW file name

CW-File-Format:
'''Standard'''
CAID:Provider ID:Service ID:PMT ID:ECM PID::key (16 Bytes seperated by spaces)
example:
1234:123456:1234:2345:3456::00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

'''Extended OSCam-Format'''
CAID:Provider ID:Service ID:PMT ID:ECM PID:Video PID:key (16 Bytes seperated by spaces)
example:
1234:123456:1234:2345:3456:7890:00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

Examples for device parameters
device = /dev/ttyS0 # (Reader on COM1 (Linux i386 and Windows))
device = /dev/tts/1 # (Reader on COM2 (Linux dbox2 with multicam))
device = /dev/ttyUSB0 # (Reader on USB (Linux i386))
device = /dev/ttyUSB0:1 # Slot 1 SC8in1 or MCR 4/8 (Linux i386)

'''Attention:''' Counting begins with 0, that means number of device is one less than number of COM-Port! Eg ttyS0 = COM1, tts/1 = COM2.

==== detect ====
{{Depends/en}}

status detect of card '''is in'''
analysis by fun7:

Detect = CD - Carrier Detect, is a line that is used by the switch (open / closes a circuit)
for '''protocol = mouse'''
'''default'''

Detect = DSR - Data Set Ready: is a V24 / (RS232) interface signal that is transmitted on PIN 6 of a D-SUB connector.
I guess the detection itself has to be processed by the cardreaders ICs itself and is later on beeing
transmitted on pin6.

Detect = CTS - Clear To Send) - RTS - Ready to send : A RTS (ready to send) request is beeing send out from the reader.
Usually the oscam will answer with a '''CTS''' (clear to send) response, telling its ready to receive.
That feature had a common use on analog modems in the past.

Detect = RING - Ring Indicator: this describes a so called RING indicator - like the ring of a telephone - that is specified
in the RS232 specs to signalize an incoming call. In the context of oscam this should mean: reader is ringing
the oscam after card insertion, telling the oscam its desire to create a data connection. Like the word "ring"
indicates, this was used in serial connections of modems as well.

Detect = NONE - detect switched off, but signal "card is in"

Detect = GPIO - GPIO means "general purpose input output". Used for '''mipsel-uclib''', I could imagine this could be useful if
you want to play around with a '''raspberry pi''' and transmit the cardstatus to its gpio pin.
[gpio1,...gpio7]

* Inverse = prefix "!"(eg "detect=!CTS")

example
[reader]
label = mymouse
description = mymouse xxx
'''protocol = mouse'''
device = /dev/ttyUSB0 (easymouse 2)
services = xxx
boxkey = 1122334455667788
force_irdeto = 1
'''detect = cd'''
mhz = 1000
cardmhz = 600
group = 1,2,3
emmcache = 1,3,2

==== cardmhz ====
{{Depends/en}}
CHANGE svn7046:06/12/12

set standard SC frequency in units of 10 kHz, for Irdeto SC set to 600, refer to [[OSCam/en/examples/Overclocking|Overclocking]]
Example:
cardmhz = 600 # Irdeto card
= # [blank] 357 (default)

'''INTERNAL READERS'''

If you use cardmhz >2000 OScam will switch to PLL clocking. Internal readers of boxes from Dream Multimedia GmbH can be clocked more precise with it.

The used cardmhz should reflect the highest frequency of the PLL crystal in the internal cardreader. OSCam will calculate the best PLL divider that comes nearest to the wanted user card speed specified in cardmhz.

Use the following settings:

Models with PPC-CPU (DM500/DM600/DM7000/DM7020) use "cardmhz = 3150"

Models with MIPS-CPU (DM500HD/DM800/DM800SE/DM8k/DM7020HD etc.) use "cardmhz = 2700"

DM7025 is special, use "cardmhz = 8300"

'''If only the parameter cardmhz is set (without mhz = xxx) then Oscam clocks the card automatically with the ATR! '''

E.G. You have a dream 800 HD PVR, thats a mips so you should set cardmhz to 2700. We got a nagra card that should run on 5 MHz. If

you want to clock the card ok just use cardmhz = 2700 an mhz = 500. If you want to overclock it use cardmhz = 2700 and mhz = 900.

Now your card will start to run 9 Mhz. Better monitor it! An overclocked card could run hot or crash suddenly!

Keep in mind that most internal readers of non-dreamboxes clock the cards automatically and copletely ignore any user clockspeed setting. But you should set cardmhz and mhz anyway, as its still used to calculate the correct timings in OSCam. If you set cardmhz/mhz correct the timings will better match with the actual (automatically) clockspeed of the internal card reader. As for a result slighly better ecm responses or more stable functioning.

Dont expect magic here, only overclocking the cardspeed can reduce the ecm response time. Bad timings can only delay it or make the card responses instable!
[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== mhz ====
{{Optional/en}}
CHANGE svn 9064:12/13/2013

set reader frequency in units of 10 kHz, if mhz > cardmhz you are in overclocking mode, refer to [[OSCam/en/examples/Overclocking|Overclocking]]

Example:
# Default 357
cardmhz = 600 # ( 6000 KHz = 6 MHz)
mhz = 1000 # (10000 KHz = 10 MHz)

auto clock speed in '''Dreambox mode''' set to -1. Further Informations about the various (Dream)Boxes can be found [http://www.streamboard.tv/oscam/wiki/ReaderClocks here].

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== autospeed ====
{{Optional/en}}
NEW svn9064:12/01/2013

autospeed = 0|1

autospeed = 0 disabled
autospeed = 1 (default) Sets mhz according to ATR. Currently only used for smartreader, smargo protocol and Dreambox-readers internal protocol. Other readers will be adapted to use this
parameter as well. In webif checked means 1. If you want to overclock your card set autospeed to 0.

==== deprecated ====
{{Optional/en}}
First the SC will be initialized in normal mode. If it fails, the SC will be automatically reverted to deprecated mode, so that the SC speed will not be changed and the communication will remain on normal ATR speed of 9600 baud.

deprecated = 1 use deprecated SC mode only
= 0 default

==== mode ====
{{Depends/en}}
set card init mode for '''AzBox''' reader
mode = 1 # AzBox-Reader
= 0 # none (default)

==== device_out_endpoint ====
{{Depends/en}}

CHANGE svn8013:12/29/2012

set endpoint address for FTDI chips
device_out_endpoint = 0x81 # Smargo Triple Reader port 1
= 0x82 # Smartreader+ (default)
= 0x83 # Smargo Triple Reader port 2
= 0x85 # Smargo Triple Reader port 3

==== smargopatch ====
{{Optional/en}}
NEW svn6402:02/16/2012

smargopatch = 0|1

enable workaround for smartreader+ and reader until native mode works, default = 0

==== sc8in1_dtrrts_patch ====
{{Optional/en}}
NEW svn6402:02/16/2012

sc8in1_dtrrts_patch = 0|1

enable fix for SC8in1/MCR DTR/RTS kernel bug, default = 0

==== cool_timeout_init ====
{{Optional/en}}
NEW svn6286:01/23/2012

cool_timeout_init = timeout in milli seconds, default = 0

set card init mode for '''AZBox''' internal reader

==== cool_timeout_after_init ====
{{Optional/en}}
NEW svn6253:01/17/2012

[[Datei:WarningS.png|text-bottom]] '''Attention: only for Coolstream!'''

cool_timeout_after_init = timeout in milli seconds, default = 0

set read/transmit timeout after SC init in milli-seconds for Coolstream internal reader only, default:150

==== ins2e06 ====
{{Optional}}
NEW svn9568:03/16/2014
add check control for pin payload (4 hex bytes) for NDS Videoguard 2 SCs
ins2e06 = Payload
= # none [blank] (default)
[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only
http://www.streamboard.tv/oscam/changeset/9568

==== ins7e ====
{{Optional/en}}
NEW svn5959:09/22/2011

ins7e = payload
= [none] default
Add 26 hex-bytes payload for '''NDS Videoguard 2 SCs'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only

==== ins7e11 ====
{{Optional/en}}
NEW svn6064:12/06/2011

ins7e11 = TA1 Byte
= # [none] default
= 11 # 0001 FI + 0001 DI (1 x)
= 13 # 0001 FI + 0011 DI (4 x)
= 14 # 0001 FI + 0100 DI (8 x)
= 15 # 0001 FI + 0101 DI (16 x)

Add TA1 Byte for '''NDS Videoguard 2 SCs'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only
 
==== fix07 ====
NEW svn9884:09/30/2014
{{Optional/en}}
enable 0x07 fix for NDS Viedeoguard 2 SCs
fix07 = 1 # enabled (default)
= 0 # disabled
[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only

==== force_irdeto ====
{{Optional/en}}

force Irdeto SC mode even if RSA key is set for Irdeto tunneled Nagravion SC
force_irdeto = 1 # yes
= 0 # no (default)

==== nagra_read ====
{{Optional/en}}

read '''Nagravison''' records (on NCMED cards only):
nagra_read = 0 # disabled (default)
= 1 # read all records with expired rights
= 2 # read records with valid rights only

==== rsakey ====
{{Optional/en}}
CHANGE svn7046:06/12/12

RSA key for Nagravision/Tiger SCs / CAM key data for Irdeto SCs, Conax SCs, default = none

==== fix9993 ====
{{Optional/en}}

fix9993 = 0|1

enabled fix for 9993 error with CAID 0919 SCs.

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

==== readtiers ====
{{Optional/en}}
NEW svn10376:02/02/15

readtiers = 0|1|2

method to get tiers of NDS Videoguard SCs

readtiers = 0 # disabled (default)
readtiers = 1 # ins70 (new) method
readtiers = 2 # ins76 (old) method

==== boxkey ====
{{Optional/en}}
box key for Nagravision SCs / CAM key for Irdeto SCs / sessionkey for Seca SCs / CamID for Viaccess

==== pincode ====
{{Optional/en}}

pincode for '''Conax, Cryptoworks an Viaccess''' SCs
pincode = pincode
= # [blank] default

==== boxid ====
{{Optional/en}}

NDS receiver box id
boxid = NDS box ID

==== ndsversion ====
{{Optional/en}}

set NDS '''Videoguard''' version
0 = # autodetection (default)
1 = # NDS Videoguard 1
12 = # NDS Videoguard 1+
2 = # NDS Videoguard 2

==== aeskeys ====
{{Optional/en}}

multiple 16 bytes AES keys for Viaccess SCs (the used postprocessing AES key is specified through the D2 nano of the ECM)

CAID #ident:AES key #0 CAID #0[,AES key #1 CAID #0],...[;CAID #1@ident::AES key #0 CAID #1[,AES key #1 CAID #1],...]...

special AES keys:
00 = do not return any CW, no AES key specified
FF = return CW received from the S, no AES key specified

Example:
aeskeys = 0500@012345:000102030405060708090a0b0c0d0e0f;0500@543210:0,0,0f0e0d0c0b0a090807060504030201
aeskeys = 0500@012345;key0,key1,key2,key3,key4,key5,...;0500@543210:key0,key1,key2,key3,key4,key5,...
if keys are unknown replace them with 0 exemple: 0500@012345;key0,key1,0,0,key4,key5,...

==== showcls ====
OBSOLETE svn6624:04/23/2012
{{Optional/en}}

number of classes subscriptions to show for '''Viacces-SCs'''
schowcls = quantity
= 0 # (default)

==== key ====
{{Depends/en}}
key for newcamd remote reader encryption
key = DES key

==== user ====
{{Optional/en}}
user for remote reader (name)

==== password ====
{{Optional/en}}
password for remote reader

==== mg-encrypted ====
{{Optional/en}}

VERALTET - OBSOLETE - OBSOLÈTE - ANTIQUATO

mgcamd encrypted '''gbox line'''

format:

{ <IP|hostname> { <local port> <remote port> { <password> { <level> <level> } address> }

default:
MAC address=eth0

==== services ====
{{Optional}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If loadbalancing is enabled in oscam.conf [global] among lb_mode, then there may be '''no entries'''!

[[Datei:WarningS.png|text-bottom]] '''Attention:''' The number of services that will be considered based reader, is limited to 64, or 64 times [[service-name][CAID][provid][srvid]]!

What services can the reader. This requires a oscam.services be present. The logic here is as follows (in this order):
* If the field is empty (or invalid), the request is allowed.
* When a negative service (ie, those with "!") is applicable, the request is rejected.
* If a positive service is applicable or there is no positive service, the request is allowed.
* If none of the previous points, the request is rejected.
This means that negative Services are only necessary in individual cases. Namely, if and when services has positive, but it wants to exclude some back. This is not recommended, because here comes quickly to misconfigurations. Instead, an additional service to be created that contains all the relevant channels.

[de]assignment to service group
services = [!]services[,[!]<services>]...
= [blank] is default

==== caid ====
{{Optional/en}}

caid = <CAID>[&<mask>][:<target CAID>][,<CAID>[&<mask>][:target <CAID>]]...

define and mapping of CAIDs for reader, default:all CAIDs with mask FFFF

example:
caid = 0100
caid = 0200&ffee:0300
caid = 0400&ff00:0500,0600
caid = 0702,0722
caid = 0702&ffdf (shortcut for the example above)

==== ident ====
{{Optional/en}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If in oscam.conf [global] loadbalancing is enabled among lb_mode, then there may be '''no entries'''! 
This parameter is only used for EMM and then it is not used for ECM. So you cannot force ECM to be sent to the card using this parameter. 

define CAID and ident '''SC specific''' for reader:
ident 0 <CAID>:<ident>[,ident]...[;<CAID>:<ident>[,ident]...]...

Example
ident = # 0100:123456,234567;0200:345678,456789
= # [blank] no definition (default)

==== class ====
{{Optional/en}}

define class '''in hex''' SC specific for reader:
class = 01,02,!1b,!2b # 01 and 01 yes, 1b and 2b no
= # [blank] no definition (default)

==== localcards ====
{{Optional/en}}

Use this reader (for defined CAIDs only) as "local" in LB/reader selection.
It will be handle as a local reader per LB and preferlocalcards settings. In this way, we can consider a network reader as local, like we had a cardreader.

localcards = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]....

==== chid ====
{{Optional/en}}

define '''Irdeto ChID''' for reader

Example:
chid = 0100:12
chid = 0100:12;0604:0000BA,000101,00010E,000141
= # [blank] default

==== group ====
{{required}}
CHANGE svn6103:12/21/2011

Reader assingment to group. Each reader must be listed in one or more groups. This will determine, which client has access on what reader. Valid values 1-64
group = 1....64[,1....64]....

'''set required = [blank] default not allowed!'''

Example:
Group = 1 # (one group)
Group = 1,4,5 # (more groups)

==== audisabled ====
{{Optional/en}}

exclude reader from auto AU (auto update)
audisabled = 1 # excludet
= 0 # not excludet (default)

==== auprovid ====
{{Optional/en}}
set provider ID to use the right reader for auto AU

Example
auprovid = # 123456
= # [blank] default

==== disableserverfilter ====
{{Optional/en}}
ignore caid and ident settings of reader due faulty clients
disableserverfilter = 1 # ignore
= 0 # not ignore (default)

==== inactivitytimeout ====
{{Depends/en}}
inactivity timeout in seconds

inactivitytimeout = seconds
= -1 # reconnect on network failure for '''newcamd''' based readers, even in idle
= 0 # default

==== reconnecttimeout ====
{{Optional/en}}

CHANGE svn7244:08/07/2012

Reconnect from a remote reader, if missing answers in seconds

Example
reconnecttimeout = 20 # after 20 seconds new connection
= # [blank] default

==== connectoninit ====
{{Optional/en}}
NEW svn8235:01/29/2013

connectoninit = 0|1

1 = allow newcamd connections to be established on starup although there isn't a request yet
0 = default

==== keepalive ====
{{Optional/en}}
NEW svn9810:07/22/2014

keepalive = 0|1

1 = allow cs378x TCP socket to be always connected
0 = always on if cacheex reader type

==== fallback ====
{{Optional/en}}

Define reader as fallback, standard and fallback reader must have the same group, see '''group'''!
fallback = 1 # fallbackreader
= 0 # no fallbackreader (default)

==== fallback_percaid ====
{{Optional/en}}
NEW svn8896:09/04/2013

fallback_percaid = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]...

use reader as fallback for defined CAIDs only, two digit wildcards CAIDs are possible, fallback_percaid overrules fallback. Def.=none

example:
fallback_percaid = 1234:234567;10:345678

==== emmcache ====
{{Optional/en}}

set EMM cache of local reader

[[Datei:WarningS.png|text-bottom]] '''Attention:'''

Without this parameter, no EMM are shown in the log!

Format:
'''''emmcache = <usecache>,<rewrite>,<logging>,<stb-emm>'''''

* <usecache> 0 = # disable usage of emmcache and emmstats (default)
* <usecache> 1 = # enable emmcache, emmstats and save to file if oscam is stopped
* <usecache> 2 = # enable emmcache, emmstats but dont save to file if oscam is stopped

* <rewrite> n = # determines how often one and the same EMM is written. '''only if <usecache> = 1 or 2'''

* <logging> 0 = # EMM logging disabled
* <logging> 1 = # logging EMM errors
* <logging> 2 = # logging written EMMs
* <logging> 4 = # logging skipped EMMs
* <logging> 8 = # logging blocked EMMs
* <logging> 16 = # logging audisabled EMMs

* <stb-emm> 0 = # EMM for STB are ignored (default)
* <stb-emm> 1 = # EMM for STB are sent to the reader (very specific usage)

Sumarizing this values is possible. 31 shows all kinds of messages.

Example:
emmcache = 1,3,10,0 # Cache on, write 3 x, log written (2) and blocked (8) = 10 , don't send stb-emm
emmcache = 1,2,6,1 # Cache on, write 2 x, log written (2) and skipped (4) = 6, send stb-emm

'''stb-emm''': is only handy for specific usage (Viaccess: see commit [http://www.streamboard.tv/oscam/changeset/10584 #10584] ) In Viaccess we saw some EMM-G that are for the STB and not for the card. That's why we call it EMM-STB (Set Top Box). Those EMMs are, for exemple, used to define overencryption key (AES) into the STB to encrypt STB-Card dialog.
 

==== emmreassembly ====
{{Optional/en}}
NEW svn8493:03/06/2013

OBSOLETE svn8591:04/01/2013 parameter now in oscam.user!

emmreassembly = 0|1

1 = enable EMM reassembly, default
0 = disable EMM reassembly

should be set for Viaccess and Cryptoworks readers if the client that you are using to send EMMs is reassembling than instead of just sending them to OSCam for processing

 

==== cacheex ====
{{Optional/en}}
NEW svn6044:11/27/2011

cacheex = 0|1|2|3

1 = enable cache exchange pull mode
2 = enable cache exchange push mode
3 = enable cache exchange reversepush mode
0 = default
for camd 3.5x and CCcam protocol

see also on oscam.user!

Identical cache exchange modes must be set on local OSCam server and remote OSCam user account!

===== cacheex-modes =====
===== cacheex = 1 - cachepull =====
Situation:

OSCam A reader1 has cacheex = 1

OSCam B account1 has cacheex = 1

OSCam A gets a ECM request, reader1 send this request to OSCam B,

OSCam B checks his cache:
* Not found in cache: return NOK
* Found in cache: return OK+CW
* Not found in cache, but found pending request: wait ''cacheexwaittime'' in oscam.conf [global] and check again. OSCam B never requests new EMMs.

CW-flow = B ---> A

===== cacheex = 2 - cachepush =====
Situation:

OSCam A reader1 has cacheex = 2

OSCam B account1 hastcacheex = 2

If OSCam B gets a CW, its pushed to OSCam A, reader has normal functionality and can request ECMs.
* Problem: OSCAM can only push CW's if OSCam A is connected
* Problem or feature?: OSCam A reader can request ECMs from OSCam B

CW-flow = B ---> A

===== cacheex = 3 - reversecachepush =====
Situation:

OSCam A reader 1 has cacheex = 3

If OSCam A gets a CW, its pushed to OSCam B. OSCam A never requests new ECMs.

CW-flow = A ---> B

==== cacheex_maxhop ====
{{Optional/en}}
NEW svn6691:05/07/2012

cacheex_maxhop = hops
= default = 10 hops

define maximum hops for cach exchange

==== logport ====
{{Optional/en}}

Camd 3.x reader logport, camd 3.x UDP must be activated, only works if there's no camd 3.x cascading
logport = # port number
= 0 # disabled (default)

==== ecmwhitelist ====
{{Optional/en}}

ecmwhitelist = [CAID[@provid]:]length[,length]...[;[CAID[@provid]:]length[,length]...]...

define valid ECM length in '''hex''' and provid for physical reader

example
ecmwhitelist = 10,20,30,0a,0b,0c
= 0100:10,20;0200@12345:0a,4b
[blank] = none (default) and provid 000000

[[Datei:WarningS.png|text-bottom]] '''In normal operation mode this parameter ist not required!'''

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/ECMLengthList|List of ECM lengths]]'''

==== ecmheaderwhitelist ====
{{Optional/en}}
NEW svn7480:09212012

ecmheaderwhitelist = [CAID[@provid]:]header[,header...[;[@provid]:]header[,header]...]...

set valid ECM header per CAID and provid '''in hex'''

default: none, provid = 000000

thread [[Streamboard-Thread:34748|here]]

[[Streamboard:oscam/wiki/HeaderWhitelist|HeaderWhitelist]] here

==== ratelimitecm ====
{{Optional/en}}

number of different SIDs in ECMs allowed for an interval
ratelimitecm = # number
= 0 # (default)

==== ecmnotfoundlimit ====
{{Optional/en}}
NEW svn8313:02/07/2013

ecmnotfoundlimit = count

number of ECMs with "not found" answer until the reader will be restarted, 0 = no limit (default)

==== resetcycle ====
{{Optional/en}}
NEW svn5820:08/12/2011

resetcycle = count

number of ECMs until SC reset ist performerd

[[Datei:WarningS.png|text-bottom]] '''Hint:''' Valid for physical readers only!

example:
resetcycle = 0 # disabled [default]
= 5 # reset after 5 ECM's

==== ratelimittime ====
{{Optional/en}}
NEW svn9078:09/12/2013

interval for rate limit in milliseconds
ratelimittime = # milliseconds
= 0 # (default)
 

==== ecmunique ====
{{Optional/en}}
NEW svn8491:03/06/2013

ecmunique = 0|1

1 = enable check for matching ECM hash in ratelimit slot
0 = default

Remark: parameter ratelimitecm must be set to be able to enable this option!

 

==== srvidholdtime ====
{{Optional/en}}
NEW svn9078:09/12/2013

srvidholdtime = milliseconds

time to keep service ID in ratelimit slot, during this time checking for ecmunique ist disabled.
0 = default
 

==== cooldown ====
{{Optional/en}}

cooldown = delay, duration

define cooldown:
delay = delay in milliseconds for which the reader is allowed to do more
ECM requests then defined by parameter "ratelimitecm"
default: [blank] none
duration = duration in milliseconds the reader needs to cooldown
default: [blank] none

Both parameters are mandatory when used.

'''parameter "ratelimitecm" and "ratelimittime" are required!'''

==== blocknano ====
{{Optional/en}}
list of EMM-nanos to block (in hex w/o 0x) or all EMM-nanos, only valid for physical readers!

Example:
blocknano = 45,93,7a,ff
= all
= # [blank] (default)

==== blockemm-u ====
{{Optional/en}}

block unique EMMs
blockemm-u = 0 # (no block) default
blockemm-u = 1 # (block EMMs, which are addressed to card immediatly) )

==== blockemm-s ====
{{Optional/en}}

block shared EMMs
blockemm-s = 0 # (no block) default
blockemm-s = 1 # (block EMMs, which are addressed to certain groups of cards)

==== blockemm-g ====
{{Optional/en}}

block global EMMs
blockemm-g = 0 # (no block) default
blockemm-g = 1 # (block EMMs, which are addressed to all cards)

==== blockemm-unknown ====
{{Optional/en}}

block unknown types of EMMs
blockemm-unknown = 0 # (no block) default
blockemm-unknown = 1 # (block all unknown kinds of EMMs)

==== blockemm-bylen ====
{{Optional/en}}

CHANGE svn8615:04/12/2013

blockemm-bylen = [length range,length range]... (decimal)

block all types of EMMs by length, maximum 10 values, default: none

example:
blockemm-bylen = 1-10,11-

 

==== via_emm_global ====
{{Optional/en}}

NEW svn9843:09/05/2014

via_emm_global == 0|1

enables global emm filter for '''viacces'''

'''only for camd35 (cs357x) protocol!'''

0 = default

 

====saveemm-u ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-u = 0 (default)
= 1

save unique EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

====saveemm-s ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-s = 0 (default)
= 1

save shared EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

====saveemm-g ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-g = 0 (default)
= 1

save global EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

====saveemm-unknown ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-unknown = 0 (default)
= 1

save unkown EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

==== savenano ====
{{Optional/en}}

OBSOLETE svn5947:09/09/2011

list of EMM-nanos (in hex w/o 0x) to save or all EMM-nanos. Only valid for physical readers. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

Format
nano[,nano]....|all

Beispiel
savenano = 45,93,7a,ff
= all
= # [blank] default

==== readnano ====
{{Optional/en}}
Write file (usually a copy of a file saved by savenano) to your smartcard, if no path is specified, the specified file is searched for in the configuration directory, only valid for physical readers!

Example:
readnano = write.emm
= /var/oscam/write.emm
= # [blank] (default)

==== use-ssl ====
{{Optional/en}}

NEW svn8725:06/25/20113

use_ssl = 0|1

use_ssl = 1 # use SSL for ghttp protocol
= 0 # default

==== dropbadcws ====
{{Optional/en}}

CHANGE svn5992:10/22/2011

dropbadcws = 0|1

dropbadcws = 1 # reject bad CWs, send "not found" instead of bad CWs
= 0 # default

==== disablecrccws ====
{{Optional/en}}

NEW svn6004:10/26/2011

disablecrccrws = 1 # disable cw checksum test
= 0 # enable (default)

==== lb_weight ====
{{Optional/en}}

The higher the value the higher the probability for reader selection. It's an divider for the average responstime.
lb_weight = weight
= # [blank] Default-Wert 100

See here
[[Datei:Lb_weight_calc2.png]]

==== lb_whitelist_services ====
NEW svn8656:05/22/2013
{{Optional/en}}

lb_whitelist_services = <services>,<services>....

reader assignement to service group for channels which may never be blocked by the loadbalancer to the reader , default=none 
 
 
==== lb_force_fallback ====
{{Optional/en}}

NEW - svn9739:05/19/2014

lb_force_fallback = 0|1

1 = set the reader always as fallback for load blancing without considering the readers statistics 

0 = default
 
 

==== ccc ====

===== cccversion =====
{{Depends/en}}

'''Only for CCcam'''

define CCcam version
<nowiki><mainversion>,<version>,</nowiki>

Example
cccversion = 1.2.34

===== cccmaxhops =====
{{Depends/en}}

define CCcam maximum SC distance hops
0 = local SCs only
1 = local SCs and + 1 hop
2 = local SCs and + 2 hops
and so on
default = 10

===== ccchop =====
{{Depends/en}}

ccchop = hop

Set hop for '''non''' CCCam readers

default = 0

===== cccreshare =====
{{Depends/en}}

CHANGE svn8607:04/10/2013

Define reader's CCcam reshare hop

cccreshare = -1 # no resharing
= 0 # reshare for direct peer only
= 1 # reshare for direct peer and next level
= x # resharing for direct peer and share level x

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 !

===== cccwantemu =====
{{Depends/en}}

Request to provide emu from CCCam server, too.
cccwantemu = 1 # yes
= 0 # no (default)

===== ccckeepalive =====
{{Depends/en}}

Send keepalive messages to keep connection to remote CCCam server up
ccckeepalive = 1 # yes
= 0 # no (default)

===== cccreconnect =====
{{Optional/en}}

cccreconnect = timeout (milli-seconds)

reconnect again after ECM request timeout in milli-secons, default = 12000 milliseconds

===== cccmindown =====
{{Depends/en}}

Filters all readers with hops smaller than number
cccmindown = # number
= 0 # default

 
 

==== '''gbox''' ====
NEW svn8350:02/15/2013
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
[reader]
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 
===== device =====
{{required}}

device = Comma-separated list of values:

peer's IP or hostname
peer's port

example:
192.168.1.101,3820

 

===== password =====
{{required}}

password = 4 hex bytes, 8 chars

peer password

example:
A123BCDE

 

===== my_password =====
{{required}}

OBSOLETE svn9163:12/31/2013 '''moved to oscam.conf [gbox]'''

Passwort = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

===== gbox_reshare =====
{{Optional/en}}

Reshare-Level of local card(s), default = 0

 

===== gbox_max_distance =====
{{Optional/en}}

gbox_max_distance = max distance to receive peer cards, default = 2

 

===== gbox_max_ecm_send =====
{{Optional/en}}

gbox_max_ecm_send = send ecm to max <gbox_max_ecm_sen> peer cards, default = 3

 

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

user name of oscam gbox

example
user = gbox_client

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
'''user must also be inserted in oscam.user [account]

'''Set suitable filters (services=, caid=, ident=) in [reader] and [account] section
'''to prevent gbox instability by overflooding with too many cards

==== '''DRE''' ====
===== exec_cmd_file =====
{{Optional/en}}

exec_cmd_file = path_to_a_script

===== stmkeys =====
{{Optional/en}}

stmkeys = path_to_a_key_file

===== force_ua =====
{{Optional/en}}

force_ua = 4 Bytes or 8 chars (expressed in hexa)

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2017-01-11T19:20:26Z

Pr2: /* gsms_disable */

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

==== httpshowmeminfo ====
{{Optional/en}}

httpshowmeminfo = 0|1
1 = display memory usage informations in Status screen
0 = do not show (default)

==== httpshowloadinfo ====
{{Optional/en}}

httpshowloadinfo = 0|1
1 = display load average and CPU usage informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== cs378x (TCP) ===
Section required only if cs378x (camd 3.5x in TCP) will be used as client protocol!

{{OSCamConfCs378xParameter}}

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

Port(s) TCP for Cs378x clients (camd 3.5x in TCP mode). Port(s) must be opened at router!

port@CAID[:ident][,ident]...[;port@CAID[:ident][,ident]...]...

Example:
port = 15000@0500:030B00;22764@0648

==== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port= define incoming UDP port(s) used by Gbox protocol

port= port#1[[,port#2]...[,port#32]]

Maximum 32 ports.

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

0 - Gbox Short Message Service (GSMS) is enabled 
1 - disable gbox short message service (GSMS) 
 
default = 1

 
 

==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

==== gbox_save_gsms ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_save_gsms=0|1

0 = don't save GSMS in configuration 
1 = save all GSMS field in configuration

You need to press save button to really save it!
 
 

==== gbox_msg_type ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_msg_type=0|1

0 = normal text message 
1 = normal text message + OSD (On Screen Display)
 
 

==== gbox_dest_peers ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_dest_peers = [BOXID[,BOXID]...[,BOXID]]

Maximum 16 * 2 bytes (4 hexa digits), comma-separated. For broadcast to all use FFFF.
 
 

==== gbox_msg_txt ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_msg_txt=Your text to send to peers.

From 6 to 127 alphanumerical characters.
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2017-01-11T19:19:11Z

Pr2: /* gsms_disable */ The default is changed to 1 in source code

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

==== httpshowmeminfo ====
{{Optional/en}}

httpshowmeminfo = 0|1
1 = display memory usage informations in Status screen
0 = do not show (default)

==== httpshowloadinfo ====
{{Optional/en}}

httpshowloadinfo = 0|1
1 = display load average and CPU usage informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== cs378x (TCP) ===
Section required only if cs378x (camd 3.5x in TCP) will be used as client protocol!

{{OSCamConfCs378xParameter}}

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

Port(s) TCP for Cs378x clients (camd 3.5x in TCP mode). Port(s) must be opened at router!

port@CAID[:ident][,ident]...[;port@CAID[:ident][,ident]...]...

Example:
port = 15000@0500:030B00;22764@0648

==== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port= define incoming UDP port(s) used by Gbox protocol

port= port#1[[,port#2]...[,port#32]]

Maximum 32 ports.

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

0 - Gbox Short Message Service (GSMS) is enabled
1 - disable gbox short message service (GSMS) 
 
default = 1

 
 

==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

==== gbox_save_gsms ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_save_gsms=0|1

0 = don't save GSMS in configuration 
1 = save all GSMS field in configuration

You need to press save button to really save it!
 
 

==== gbox_msg_type ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_msg_type=0|1

0 = normal text message 
1 = normal text message + OSD (On Screen Display)
 
 

==== gbox_dest_peers ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_dest_peers = [BOXID[,BOXID]...[,BOXID]]

Maximum 16 * 2 bytes (4 hexa digits), comma-separated. For broadcast to all use FFFF.
 
 

==== gbox_msg_txt ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_msg_txt=Your text to send to peers.

From 6 to 127 alphanumerical characters.
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2017-01-11T18:26:30Z

Pr2: /* GBox */

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

==== httpshowmeminfo ====
{{Optional/en}}

httpshowmeminfo = 0|1
1 = display memory usage informations in Status screen
0 = do not show (default)

==== httpshowloadinfo ====
{{Optional/en}}

httpshowloadinfo = 0|1
1 = display load average and CPU usage informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== cs378x (TCP) ===
Section required only if cs378x (camd 3.5x in TCP) will be used as client protocol!

{{OSCamConfCs378xParameter}}

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

Port(s) TCP for Cs378x clients (camd 3.5x in TCP mode). Port(s) must be opened at router!

port@CAID[:ident][,ident]...[;port@CAID[:ident][,ident]...]...

Example:
port = 15000@0500:030B00;22764@0648

==== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port= define incoming UDP port(s) used by Gbox protocol

port= port#1[[,port#2]...[,port#32]]

Maximum 32 ports.

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

==== gbox_save_gsms ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_save_gsms=0|1

0 = don't save GSMS in configuration 
1 = save all GSMS field in configuration

You need to press save button to really save it!
 
 

==== gbox_msg_type ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_msg_type=0|1

0 = normal text message 
1 = normal text message + OSD (On Screen Display)
 
 

==== gbox_dest_peers ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_dest_peers = [BOXID[,BOXID]...[,BOXID]]

Maximum 16 * 2 bytes (4 hexa digits), comma-separated. For broadcast to all use FFFF.
 
 

==== gbox_msg_txt ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_msg_txt=Your text to send to peers.

From 6 to 127 alphanumerical characters.
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2017-01-11T18:25:03Z

Pr2: /* gbox_save_gsms */

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

==== httpshowmeminfo ====
{{Optional/en}}

httpshowmeminfo = 0|1
1 = display memory usage informations in Status screen
0 = do not show (default)

==== httpshowloadinfo ====
{{Optional/en}}

httpshowloadinfo = 0|1
1 = display load average and CPU usage informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== cs378x (TCP) ===
Section required only if cs378x (camd 3.5x in TCP) will be used as client protocol!

{{OSCamConfCs378xParameter}}

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

Port(s) TCP for Cs378x clients (camd 3.5x in TCP mode). Port(s) must be opened at router!

port@CAID[:ident][,ident]...[;port@CAID[:ident][,ident]...]...

Example:
port = 15000@0500:030B00;22764@0648

==== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port= define incoming UDP port(s) used by Gbox protocol

port= port#1[[,port#2]...[,port#32]]

Maximum 32 ports.

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

==== gbox_save_gsms ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_save_gsms=0|1

0 = don't save GSMS in configuration 
1 = save all GSMS field in configuration

You need to press save button to really save it!
 
 

==== gbox_msg_type ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_msg_type=0|1

0 = normal text message
1 = normal text message + OSD (On Screen Display)
 
 

==== gbox_dest_peers ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_dest_peers = [BOXID[,BOXID]...[,BOXID]]

Maximum 16 * 2 bytes (4 hexa digits), comma-separated. For broadcast to all use FFFF.
 
 

==== gbox_msg_txt ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_msg_txt=Your text to send to peers.

From 6 to 127 alphanumerical characters.
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2017-01-11T18:20:09Z

Pr2: /* GBox */ Add new Gbox SMS parameters

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

==== httpshowmeminfo ====
{{Optional/en}}

httpshowmeminfo = 0|1
1 = display memory usage informations in Status screen
0 = do not show (default)

==== httpshowloadinfo ====
{{Optional/en}}

httpshowloadinfo = 0|1
1 = display load average and CPU usage informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== cs378x (TCP) ===
Section required only if cs378x (camd 3.5x in TCP) will be used as client protocol!

{{OSCamConfCs378xParameter}}

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

Port(s) TCP for Cs378x clients (camd 3.5x in TCP mode). Port(s) must be opened at router!

port@CAID[:ident][,ident]...[;port@CAID[:ident][,ident]...]...

Example:
port = 15000@0500:030B00;22764@0648

==== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port= define incoming UDP port(s) used by Gbox protocol

port= port#1[[,port#2]...[,port#32]]

Maximum 32 ports.

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

==== gbox_save_gsms ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_save_gsms=0|1

0 = don't save GSMS in configuration
1 = save all GSMS field in configuration

You need to press save button to really save it!
 
 

==== gbox_msg_type ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_msg_type=0|1

0 = normal text message
1 = normal text message + OSD (On Screen Display)
 
 

==== gbox_dest_peers ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_dest_peers = [BOXID[,BOXID]...[,BOXID]]

Maximum 16 * 2 bytes (4 hexa digits), comma-separated. For broadcast to all use FFFF.
 
 

==== gbox_msg_txt ====
{{Optional/en}}
NEW svn11328:01/11/2017

gbox_msg_txt=Your text to send to peers.

From 6 to 127 alphanumerical characters.
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/fr/Config/oscam.conf

2017-01-01T11:39:15Z

Pr2: /* port */ Corrige la définition du port pour Cs378x

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

== oscam.conf ==
Le fichier principal de configuration pour Oscam est composé de paramètres globaux pour son fonctionnement.
Ces paramètres permettent de personnaliser Oscam tels que le débogage, l’historique du système, le monitoring, les protocoles et l’anticascade.
La section [global] est requise.
Toutes les autres sections caractérisées par des crochets [] sont optionnelles

=== Paramètres globaux ===
Les paramètres suivants sont repris dans la section globale:

{{OSCamConfGlobalParameter}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Si un paramètre n'est pas repris dans le fichier de configuration ou si aucune valeur n'est mentionnée pour ce paramètre, la valeur par défaut sera automatiquement appliquée!

==== nice ====
{{Pasindispensable}}

'''Priorité du système'''. OSCam nécessite peu de ressource CPU. Mais si elle est nécessaire, elle doit être disponible immédiatement. Les valeurs vont de 20 à-20, ou 20 est la priorité la plus basse et -20 la plus haute. Si ce paramètre est commenté(#), cette fonction n'est pas active. Ceci est important pour la dbox2 [http://de.wikipedia.org/wiki/DBOX2], quand l'erreur "''relocation error:setpriority''" apparait. Vgl. [http://de.wikipedia.org/wiki/Prioritätsscheduling Prioritätsscheduling]

Exemple:
nice = -1

Par défaut:
nice = 99

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

Debug-Level:
0 = pas de débug (défaut)
1 = messages d'erreurs détaillés
2 = analyse ATR, affichage ECM, affichage CW
4 = trafic de/vers les lecteurs
8 = trafic de/vers les clients
16 = trafic vers le lecteur physique au niveau IFD
32 = trafic vers le lecteur physique au niveau I/O
64 = affichage des EMMs
128 = affichage au niveau DVB API
256 = affichage répartiteur de charge (load balancing)
512 = affichage au niveau du cache exchange
1024 = affichage au niveau ECM client
65535 = tous les débogages.

===== pidfile =====
{{Pasindispensable}}
NOUVEAU svn:8176/01/24/2013

pidfile = filename,

pour spécifier un autre nom ou un emplacement spécifique pour le fichier pid, en [blanc] aucun (par défaut) le fichier est créé en tant que oscam.pid dans /tmp

Exemple:
pidfile = /var/run/oscam.pid

===== logfile =====
{{Pasindispensable}}

Ce paramètre fixe la destination du fichier '''journal des événements.'''
logfile = filename|/dev/null|/dev/tty/syslog

Possibilités:
logfile = /dev/null # Aucun fichier n'est créé)
logfile = /dev/tty # La sortie se fait à l'écran??
logfile = syslog # La sortie se fait dans le fichier journal du système)
logfile = /var/log/oscam.log # linux i386)
logfile = oscam.log # dans le répertoire contenant oscam (cf. /usr/bin)
logfile = stdout # Pour la sortie sur la console (en telnet)

Exemple:
logfile = /etc/oscam/logs/oscam.log

Par défaut:
logfile = /var/log/oscam.log

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

===== ecmfmt =====
{{Pasindispensable}}
NOUVEAU svn6649+6653:05/01/2012

MODIFICATIONS svn8831:08/11/2013

MODIFICATIONS svn11008-11011:09/28/15

MODIFICATIONS svn11273:08/15/16

ecmfmt = format

Définir le format du log ECM, par défaut = c&p/i/s/l:h

Variables possible:
c = CAID
d = PID
e = CSP hash
g = ID du peer gbox
h = checksum (somme de contrôle)
i = Channel ID
j = distance en hops gbox et CCcam
l = longueur
o = ONID
p = provider ID
s = service ID
t = tier ID , cet identifiant est remplacée par la description des oscam.tiers (le cas échéant)
w = CW
y = payload (court, 3 bytes)
Y = payload (long, 6 bytes)

utilisez une valeur comme préfixe pour cacher une variable de cette valeur

Exemple:
ecmfmt = c&0p/i/d/s/l:h HOP:j
(cache les providers ID s'ils sont nuls)

===== nds_swap_cw =====
{{Pasindispensable}}

NOUVEAU svn:10003/11/15/2014

OBSOLÈTE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs sont insérés, si les CWs ne sont pas les mêmes ou n'ont pas un modèle similaire (par défault)
1 = désactivé

===== loghistorysize =====
{{Pasindispensable}}

loghistorysize = bytes

La taille du message de l'histoire du log dans la WebIf ou le monitor peut maintenant être configurée.

0 = désactivé, par défaut = 4096

===== CACHE EXCHANGE LOGGING =====
NOUVEAU svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 est utilisé uniquement quand '''preferlocalcards = 1''' était mis en place dans la section [global].
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

Example

P/2/2/2 or L/2/4/4

===== maxlogsize =====
{{Obligatoire}}

Détermine la taille du journal. Cela est très utile pour des serveurs avec une mémoire réduite (Par ex. la dbox2). Il est fortement recommandé de déterminer avec soin la taille du fichier journal pour de tels serveurs. Il n'est pas rare qu'un système crashe car la taille de ces fichiers est devenue trop grande.

Exemple
maxlogsize = 20 # La taille du journal peut atteindre 20 Ko
= 0 # La taille du journal est '''illimitée'''

Valeur par défaut:
maxlogsize = 10 # La taille du journal peut atteindre 10 Ko(défaut)

===== logduplicatelines =====
{{Pasindispensable}}
NOUVEAU svn:8290/02/05/2013

logduplicatelines = 0|1

= 1 active l'écriture des lignes en double dans le log
= 0 désactive l'écriture des lignes en double dans le log (défaut)

===== disablelog =====
{{Pasindispensable}}

Désactive le fichier '''journal des événements'''
1 = Activé, donc pas de fichier '''journal''' -
0 = Désactivé, un fichier '''journal''' sera créé

Exemple:
disablelog = 1 # il n'y aura '''pas''' de fichier journal

Par défaut:
disablelog = 0 # '''un''' fichier journal sera créé

===== cwlogdir =====
{{Pasindispensable}}

Détermine l'emplacement du répertoire contenant l'historique des '''cw'''

Exemple:
cwlogdir = /var/log/cw.log

Par défaut:
cwlogdir = # [rien] aucun répertoire pour l'historique des "cw"

===== emmlogdir =====
{{Pasindispensable}}

emmlogdir = répertoire

Pour définir l'emplacement des EMM sauvegardés par le paramètre "saveemm-*"- dans la section reader du fichier oscam.server. Si le paramètre n'est pas activé, le comportement antérieur (répertoire de configuration) s'applique.

===== usrfile =====
{{Pasindispensable}}

Nom du fichier '''"journal des utilisateurs"'''.

Ce fichier contient les informations suivantes
La date.
L’heure.
Les CWs par seconde.
Le nom de l’utilisateur.
L’adresse IP de l’utilisateur.
Le port TCP/IP.
Les CWs trouvés.
Les CWs du cache.
Les CWs non trouvés.
Les CWs ignorés.
Les CWs expirés.
Les CWs dans le tunnel.
L’heure de l’ouverture de la session au format Unix / Posix.
L’heure de clôture de la session au format Unix / Posix.
Le protocole utilisé.

Exemple:
usrfile = userfile

Par défaut:
usrfile = 0

===== disableuserfile =====
{{Pasindispensable}}
Comme le "journal des événements", "'''le journal des utilisateurs'''" peut être désactivé

Exemple:
disableuserfile = 1 # '''aucun''' fichier journal des utilisateurs n'est créé
= 0 # '''un''' fichier journal des utilisateurs est créé

Par défaut:
disableuserfile = 0

Les ouvertures de sessions seront enregistrées
1 = Chaque zapping du client sera enregistré dans le fichier

Exemple:
usrfileflag = 1 # Tout est enregistré

Par défaut:
usrfileflag = 0 # n'enregistrera que les ouvertures et fermeture de session

===== usrfileflag =====
{{Pasindispensable}}

Mode d’enregistrement du fichier journal des utilisateurs
0 = Seul les ouvertures et clôtures de connexion seront logguées

===== saveinithistory =====
{{Pasindispensable}}

OBSOLÈTE svn7128:07/02/2012

Enregistrement de l'initialisation du lecteur. Ce paramètre est utilisé pour la lecture des droits de la carte.

Exemple:
saveinithistory = 1 # Enregistrement dans /tmp/.oscam/reader<N°>

Valeur par défaut:
saveinithistory = 0 # Pas d'enregistrement

===== disablemail =====
{{Pasindispensable}}

disablemail = 0 (par défaut c'est 1)

Ce paramètre permet de sauvegarder les messages courriels envoyés par les fournisseurs aux abonnés.

Pour l'instant, c'est valables uniquement pour le NDS, je ne sais pas si ça viendra pour les autres systèmes dans l'avenir.

===== mailfile =====
{{Pasindispensable}}

mailfile = /répertoire/fichier

Ce paramètre permet de sauvegarder les e-mails (courriels) envoyés par les diffuseurs aux abonnés.

Pour l'instant, cette option n'est disponible que pour le cryptage NDS. Nous ne savons pas si cela viendra sur d'autres contrôles d'accès.

===== cacheex_mode1_delay =====
{{Pasindispensable}}

NOUVEAU svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

Délai en millisecondes pour une demande d'échange de cache mode 1 par défaut: pas de délai

==== Reader ====

===== enableled =====
{{Pasindispensable}}

NOUVEAU svn6285:01/23/2012

LED-Support

enableled = 0|1|2

0 = LED désactivé
1 = LED activé pour routers
2 = LED activé pour qboxhd,
par défaut = 0

===== serialreadertimeout =====
{{pasindispensable}}

OBSOLÈTE svn8541:03/13/2013

'''Seulement quand un lecteur série est utilisé'''
Timeout en millisecondes pour un lecteur série

Exemple:
serialreadertimeout = 1200 # Timeout après 1200 Millisecondes

Par défaut:
serialreadertimeout = 1500 # Timeout après 1500 Millisecondes

===== waitforcards =====
{{Pasindispensable}}

On détermine ici si au démarrage du programme, OSCam attend les cartes locales avant d'ouvrir les connexions réseaux.

Exemple:
waitforcards = 0 # N'attend pas

Par défaut:
waitforcards = 1 # Attend

===== waitforcards_extra_delay =====
{{Pasindispensable}}

waitforcards_extra_delay =

Retard de réponse supplémentaire pour les problèmes d'initialisation des readers (ou lecteurs).

Par défaut = 500 ms

===== preferlocalcards =====
{{Pasindispensable}}
MODIFICATIONS svn9605:03/29/2014

Ce paramètre détermine si les cartes locales sont utilisées en premier pour le décodage.

Exemple:
preferlocalcards = 0 # Les cartes locales ne sont pas privilégiées (remote reader)
preferlocalcards = 1 # CacheEx sources sont privilégiées
preferlocalcards = 2 # Les cartes locales sont privilégiées
Par défaut:
preferlocalcards = 1 # CacheEx sources sont privilégiées

===== readerrestartseconds =====
{{Pasindispensable}}

Détermine le temps d'attente en secondes pour le redémarrage du Reader

Exemple:
readerrestartseconds = 10 # Temps d'attente de 10 secondes
= 0 # '''Pas de redémarrage!'''

Par défaut:
readerrestartseconds = 5 # Temps d'attente de 5 secondes

===== block_same_ip =====
{{Pasindispensable}}
NOUVEAU svn7215:07/27/2012

block_same_ip = 0|1

1 = Rejeter les ecms en boucle venant de clients vers les readers avec la même adresse IP, par défaut = 1
0 = Ne pas rejeter

===== block_same_name =====
{{Pasindispensable}}
NOUVEAU svn7215:07/27/2012

block_same_name = 0|1

1 = Rejeter les ecms en boucle venant de clients vers les readers avec le même nom, par défaut = 1
0 = Ne pas rejeter

==== cache ====

Obsolet svn8358:16/02/2013 move to [cache] 

===== cachedelay =====
{{Pasindispensable}}

Obsolet svn8358:16/02/2013 move to [cache] 

Délai minimum de la mise en cache des requètes. Cela semble paradoxal vu que la '''réponse ''' venant du cache doit se faire '''aussi vite que possible''' .

Exemple:
cachedelay = 300

Valeur par défaut:
cachedelay = 0

===== max_cache_time =====
{{Pasindispensable}}

Obsolet svn8358:16/02/2013 move to [cache] 

max_cache_time = le temps (en secondes) de garder l'ECM dans le cache, par défaut = 15

The time must be 2 seconds higher than the parameter clienttimeout!

===== max_cache_count =====
{{Pasindispensable}}

Obsolet svn8358:16/02/2013 move to [cache] 

max_cache_count = nombre d'ECMs à garder dans le cache, par défaut = 1000

===== cacheexwaittime =====
{{Pasindispensable}}

Obsolet svn8358:16/02/2013

cacheexwaittime = ms

Temps maximum (en millisecondes) que le serveur de cache va attendre jusqu'à ce que l'ECM ou CW soit reçu, par défaut = 50.

===== cacheexenablestats =====
{{Pasindispensable}}

Obsolet svn8358:16/02/2013 move to [cache]

cacheexenablestats = 0|1

Ajout de statistiques cw push/got dans le webif

1 = activé
0 = défaut

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Par défaut désactivé à cause de la consommation de mémoire!

==== Client ====

===== clienttimeout =====
{{Pasindispensable}}

Fixe la durée maximum, en secondes ou millisecondes, pour traiter une requête d'un cient. Le dépassement de ce temps entraine un "timeout" (expiration du délai)

Exemple:
clienttimeout = 10 # Timeout après 10 secondes
clienttimeout = 10000 # ici aussi Timeout après 10 secondes (10000 millisecondes)

Par défaut:
clienttimeout = 5 # Timeout après 5 secondes

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Pour des valeurs < 100 le Cardserver considère que le temps est donné en secondes, si les valeurs >= 100 il interprète les valeurs comme étant des millisecondes.

===== clientmaxidle =====
{{Pasindispensable}}

Fixe la durée maximum d'inactivité d'un client en '''secondes''' avant sa déconnexion.

Exemple:
clientmaxidle = 200 # Déconnexion après 200 secondes
= 0 # Pas de déconnexion

Valeur par défaut:
clientmaxidle = 120 # Déconnexion après 120 secondes

===== suppresscmd08 =====
{{Pasindispensable}}

suppresscmd08 = 0|1
Dire aux clients 3.57x de ne pas faire à nouveau des demandes pour les CAID, ServiceID et providerID qui sont déjà rejetés. 1 = désactivé, défaut = 0

Si vous voulez en savoir plus à ce sujet lisez ceci: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== fallbacktimeout ====
{{Version}}
Dans le cas où plusieurs readers existent (Voir la section [reader] dans oscam.server) il est possible que l'un d'entre eux devienne défaillant, dans ce cas, le trafic sera redirigé ver le reader de secours '''(Fallback reader)'''

Fixe la valeur maximale en millisecondes avant que le [[Cardserver]] ne redirige le trafic du [[Reader] primaire], vers le ou les readers de secours [[Fallback]]-Reader (

Exemple:
fallbacktimeout = 1500

Valeur par défaut:
fallbacktimeout = 2500

[[Datei:WarningS.png|text-bottom]] '''Attention:''' La valeur choisie doit être supérieure au "serialreadertimeout" sinon les valeurs standards seront prises en considération

==== fallbacktimeout_percaid ====
{{Pasindispensable}}
NOUVEAU svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

durée d'expiration avant de retomber sur un lecteur de repli par CAID, par défaut: 2500

==== sleep ====
{{Pasindispensable}}

Temps d'attente en minutes pour les utilisateurs inactifs. La valeur peut-être écrasée par celle définie dans le fichier oscam.user.
Si l'utilisateur reste en permanance sur la même chaine sans zapper ce paramètre le considére comme inactif et coupe donc la connexion,
il ne faut donc pas mettre une valeur trop petite!
Vous devez activer la fonction en ajoutant sleepsend=255 au niveau de chaque utilisateur dans votre oscam.user

Exemple:
sleep = 5 # Attente 5 Minutes

Par défaut:
sleep = # [rien] pas de temps d'attente

==== serverip ====
{{Pasindispensable}}

Dans le cas d'un serveur comportant plusieurs cartes réseau et donc plusieurs adresses IP différentes, il peut être souhaitable que Oscam ne réponde que si la demande provient d'une adresse IP bien déterminée. Avec ce paramètre, vous pouvez spécifier quelle adresse IP oscam "écoute" .

Exemple:
serverip = 192.168.178.1

Oscam ne répondra qu'aux demandes transitant par cette adresse

Par défaut:
serverip =

OSCam écoute toutes les adresses IP.

==== bindwait ====
{{Pasindispensable}}

Fixe le temps maximum que le [[Cardreader]] peut utiliser au démarrage pour se connecter aux ports réseau. Si la liaison ne s'établit pas dans le délai fixé, elle est annoncée par la mention "Bind Request failed". Les différentes causes sont :
* Double emploi des ports;
* Une session précédente d'OSCam n'a pas libéré les ports;
* Plusieurs sessions d'OSCam tournent

Exemple:
bindwait = 20 # délai 20 secondes

Valeur par défaut:
bindwait = 120 # délai de 120 secondes

==== netprio ====
{{Pasindispensable}}

Détermine la priorité du Cardserver sur le réseau

Exemple:
netprio = 1 # Priorité 1

Valeur par défaut:
netprio = 0 # priorité donnée par le système

==== resolvegethostbyname ====
{{Pasindispensable}}

Type de résolution DNS
0 = reçoit l'info par adresse ip (défaut)
1 = recoit l'info par nom d'hôte

Exemple:
resolvegethostbyname = 1 # Le nom de l'hôte est mentionné

Valeur par défaut:
resolvegethostbyname = 0 # l'adresse est mentionnée

====failbancount====
{{Pasindispensable}}

Failbancount = Nombre de tentatives de connexion erronées autorisé.
= 0 (valeur par défaut) L'IP est directement bloquée si le mot de passe n'est pas correct!

Si dans '''failbantime''' les demandes de connexion invalides enregistrées sont supérieures à '''failbancount''', l'adresse IP sera bloquée pour le temps restant du Failbantime. Quand le temps du failbantime est dépassé, c'est de nouveau le failbancount qui est d'application. Failbancount est un assouplissement des règles.

==== failbantime ====
{{Pasindispensable}}

Fixe le délai pendant lequel l'IP d'un client est bloquée, s'il effectue des tentatives de connexion non valides.

Exemple:
failbantime = 5
# L'adresse IP est bloquée pendant 5 minutes. Les tentatives de connexion seront ignorées même si le login est OK.
# Aucun thread ne sera démarré pour ce client.

Valeur par défaut
failbantime = 0 # le failban est désactivé (valeur par défaut)

==== dropdups ====
{{Pasindispensable}}

dropdups = 0|1, par défaut = 0

Mode pour les doubles connexions (duplicate); condition requise: uniq > 0

0 = marque les clients comme duplicate, mais il ne seront pas déconnectés (défaut)
1 = abandonne les doubles connexions au lieu de les marquer comme "duplicate".

==== unlockparental ====
{{Pasindispensable}}
MODIFICATIONS svn7289:08/27s/2012

'''Seulement pour Seca/Viaccess et Videoguard2'''

Cette option modifie le code de moralité des cartes pour permettre le décodage des programmes pour adultes sans avoir à saisir le code parental.

Exemple:
unlockparental = 1 # déverrouillé (pas de demande de code)

Par défaut:
unlockparental = 0 # verrouillé (le code est demandé)

Note: le pin code renseigné dans la configuration de la carte doit être correct

==== double_check ====
{{Pasindispensable}}

'''Uniquement si le double check du CW est nécessaire!'''

Les ECM sont envoyés à 2 lecteurs ou plus ayant la même carte et les CW sont comparés. lb_nbest_readers doit avoir une valeur égale ou supérieure à 2

Exemple:
double_check =

Valeur par défaut:
double_check = 0

==== double_check_caid ====
{{Pasindispensable}}
Nouveau svn:7237/08/05/2012/span>

double_check_caid = caid1,caid2,...,caidn
ou
double_check_caid = system1,system2,...,systemn

Où systemx sont les deux premiers octets du caid, exemple: 01, 05, 17, 18....

ECM sera envoyé à deux ou plusieurs readers avec la même carte et les CWs seront comparés pour les CAID ou les deux premiers octets des CAID définis, lb_nbest_readers doit être configuré sur 2 ou plus, par défaut: rien

==== Loadbalancer ====

===== lb_mode =====
{{Pasindispensable}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Si l'équilibrage de charge est activée ici, elle peut en oscam.server entre les services et Ident sont pas les entrées!

Loadbalance Mode

Lorsque deux ou plusieurs cartes du même type sont présentes (en local ou proxies), il est possible de distribuer la charge de manière proportionnelle sur les cartes (balancer).

Exemple:
lb_mode = 0 (désactivé)
lb_mode = 1 (le Reader le plus rapide est sélectionné en premier lieu)
lb_mode = 2 (Le Reader n'ayant pas été utilisé précédemment est sélectionné)
lb_mode = 3 (Le Reader ayant la charge la plus faible est sélectionné)
lb_mode = 10 (uniquement logging )

Par défaut:
lb_mode = 0 # désactivé

===== lb_save =====
{{Pasindispensable}}

Enregistre les statistiques du Loadbalance, de sorte qu'elles soient disponibles même après un redémarrage.
Afin de ne pas surcharger le CPU il est conseillé de choisir des valeurs > 100 .

Exemple:
lb_save = 100 # Nombre d'ecm avant l'enregistrement des statistiques

Par défaut:
lb_save = 0 # Pas d'enregistrement de statistiques

===== lb_nbest_readers =====
{{Pasindispensable}}

Nombre de Readers pour la demande d'ECM.

Exemple:
lb_nbest_readers = 2 # La demande est envoyée à deux Readers

Valeur par défaut:
lb_nbest_readers = 1 # La demande est envoyée à un Reader

===== lb_nfb_readers =====
{{Pasindispensable}}

Nombre de Fallback Reader pour l'équilibrage de charge.

Exemple:
lb_nfb_readers = 2 # Deux Fallbackreader

Valeur par défaut:
lb_nfb_readers = 1

===== lb_reopen_mode =====
{{Pasindispensable}}

OBSOLÈTE svn8642:05/10/2013

lb_reopen_mode = 0|1

Loadbalancer: Option pour la réouverture rapide ou après un certain temps des lecteurs bloqués.

0 = réouverture après un certain temps (par défaut)
1 = réouverture rapide

===== lb_nbest_percaid =====
{{Pasindispensable}}

MODIFICATIONS svn5893:08/19/2011

lb_nbest_percaid = caid1:lbn1,caid2:lbn2,...,caidn:lbnn

Nombre de meilleurs readers par CAID.
Comme nbest_readers, mais pour des CAIDs spécifiques, wildcard CAIDs avec 2 chiffres-CAIDs sont possibles

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

===== lb_reopen_invalid =====
{{Pasindispensable}}

NOUVEAU svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wird so lange blockiert, bis die Statistik aufgeräumt ist
1 = default

===== lb_force_reopenalways =====
{{Pasindispensable}}

NOUVEAU svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = ouvre tous les lecteurs arrêtés, si aucun lecteur fonctionnel n'a été trouvé.
0 = par défaut

===== lb_min_ecmcount =====
{{Pasindispensable}}

Nombre minimum d ECM's pris en compte pour l’évaluation des valeurs d’équilibrage des charges.

Exemple:
lb_min_ecmcount =

Valeur par défaut:
lb_min_ecmcount = 5

===== lb_max_ecmcount =====
{{Pasindispensable}}

Nombre maximum d ECM's pris en compte pour l’évaluation des valeurs d’équilibrage des charges..

Exemple:
lb_max_ecmcount =

Valeur par défaut:
lb_max_ecmcount = 500

===== lb_reopen_seconds =====
{{Pasindispensable}}

Délais en seconde avant une nouvelle tentative de connexion aux lecteurs/CAIDs/providers/services

Exemple:
lb_reopen_seconds = 500 # Nouvelle tentative après 500 secondes

Valeur par défaut:
lb_reopen_seconds = 900

===== lb_retrylimit =====
{{Pasindispensable}}

Tentative de connexion au reader suivant, '''seulement''' quand le temps de réponse dépasse le temps fixé ici en: '''Millisecondes'''.

Exemple:
lb_retrylimit = 500 # Tentative de connexion au reader suivant, quand le temps de réponse dépasse 500ms.

Valeur par défaut:
lb_retrylimit = 800

===== lb_savepath =====
{{Pasindispensable}}

Nom du fichier de sauvegarde des statistiques pour l'équilibrage des charges (loadbalance)

Fichier par défaut = /tmp/.oscam/stat

===== lb_stat_cleanup =====
{{Pasindispensable}}

Nombre d'heures après lequel les statistiques pour l'équilibrage des charges (loadbalance) sont remises à 0

Valeur par défaut = 336

===== lb_use_locking =====
{{Pasindispensable}}
OBSOLÈTE svn6166

Supprime les demandes parallèles et identiques d'ECM

1 = activé
0 = désactivé# valeur par défaut:0
 
'''Schlocke:'''
* Cette option ne doit être activée qu'en cas:
** Lenteur du système
** Charge élevée
** S'il n'est pas répondu aux demandes d'ECM identiques par le cache, mais si les readers sont sollicités

* Avantage de l'activation:
** De par la synchronisation, les demandes d'ECM sont exécutées les unes après les autres, et l'attribution de ces demandes au cache ou au reader par le loadbalance réussit toujours.

* Inconvénient de l'activation:
** La Synchronisation empêche le fonctionnement du Multi-threading et des temps de réponse élevés peuvent apparaître

* Avantages en cas de NON activation:
** Exécution plus rapide des demandes d'ECM

* Inconvénient en cas de NON activation:
**Demande multiple d'ECM à un Reader
 

===== lb_retrylimits =====
{{Pasindispensable}}

MODIFICATIONS svn:5754:07/31/2011


lb_retrylimits = caid1:time1,caid2:time2,...,caidn:timen

Vous pouvez configurer un retrylimit par caid, wildcard CAIDs avec 2 chiffres-CAIDs sont possibles

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

===== lb_noproviderforcaid =====
{{Pasindispensable}}

MODIFICATIONS svn5758:08/01/2011

lb_noproviderforcaid = caid1,caid2,...,caidn

Pour ignorer les providers; ne pas stocker les statistiques du loadbalancer avec les providers pour ce(s) caid(s), wildcard CAIDs avec 2 chiffres-CAIDs sont possibles

example:
lb_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

===== lb_auto_timeout =====
{{Pasindispensable}}
NOUVEAU svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # active l'expiration automatique basé sur les statistiques du répartiteur de charge (load balancer)
= 0 # par défaut

===== lb_auto_timeout_p =====
{{Pasindispensable}}
NOUVEAU svn 7564:10/02/2012

lb_auto_timeout_p = percent

pourcentage ajouté au au temps moyen comme valeur de timeout
défaut = 30

===== lb_auto_timeout_t =====
{{Pasindispensable}}
NOUVEAU svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

temps minimum ajouté au temps moyen comme valeur de timeout
défaut = 300

===== lb_max_readers =====
{{Pasindispensable}}

lb_max_readers =

Loadbalancer: limiter la quantité (nombre) de lecteurs pendant l'apprentissage.

0 = illimité (par défaut)
un nombre = restreindre le loadbalancer au nombre de lecteurs.

===== lb_auto_betatunnel =====
{{Pasindispensable}}

lb_auto_betatunnel = 0|1

1 = activer la détection automatique de la tunnelisation Betacrypt pour les Caïds 1801, 1833, 1834 et 1835 pour loadbalancing, la configuration Betacrypt avec betatunnel dans oscam.user sera préférée, par défaut = 1

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Les inscriptions pour oscam.user de betatunnel être préféré [[streamboard:wiki/OSCam/fr/Config/oscam.user#betatunnel|User-Betatunnel]]

===== lb_auto_betatunnel_mode =====
{{Pasindispensable}}

NOUVEAU svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

définir le mode pour le tunneling Betacrypt automatique

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

===== lb_auto_betatunnel_prefer_beta =====
{{Pasindispensable}}

NOUVEAU svn6045:11/27/2011

MODIFICATIONS svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = Auswahl (Zahl)

La préférence pour Betacrypt/Nagravision peut être sélectionnée.

0 = désactivé (défaut)
1 = toujours Betacrypt
105 = sélectionne une valeur moyenne
200 = toujours Nagravision

=== Monitor ===
Paramètres pour l'utilisation de la section [monitor]!

{{OSCamConfMonitorParameter}}

==== port ====
{{Pasindispensable}}

Port UDP pour le paramètre moniteur
port = 0 # Pas de moniteur
= # [vide] Pas de port sélectionné

Exemple:
port = 24480 # Moniteur activé sur le Port 24480

==== serverip ====
{{Pasindispensable}}

Lie le service à une adresse IP déterminée
serverip = # Adresse IP
= # [vide] toutes les adresses IP (valeur par défaut)

==== nocrypt ====
{{Pasindispensable}}

Connexion non sécurisée au moniteur.

Possibilités
* une ou plusieurs adresses IP
* une ou plusieurs plages d'adresses IP
* un mélange d'adresses uniques et de plages d'adresses IP

Exemple
nocrypt = 127.0.0.1,192.168.0.0-192.168.255.255
= Hôte 127.0.0.1 et la plage d'IP allant de 192.168.0.0 à 192.168.255.255
Valeur par défaut
nocrypt = # [vide] pas de connexion non sécurisée au moniteur

==== aulow ====
{{Pasindispensable}}

Exemple
aulow = 30 # Après 30 minutes sans EMM, le client est mis de "active" sur "on" (par défaut).

==== monlevel ====
{{Pasindispensable}}

Monitor-Level
0 = Pas d'accès au Moniteur (valeur par défaut)
1 = Seulement le server et ses propres procédures
2 = Toutes les procédures, seulement visualisation
3 = Toutes les procédures, rechargement de oscam.user possible
4 = Accès complet

Exemple
monlevel = 4 # Accès complet

Monlevel peut être changé par utilisateur dans le oscam.user!

==== hideclient_to ====
{{Pasindispensable}}

Temps en seconde après lequel les clients n'introduisant pas de requêtes sont masqués . Voir aussi le paramètre '''httphideidleclienst''' dans la section [webif].
hideclient_to = 1 # Les clients sont masqués
= 0 # Les clients restent visibles

==== appendchaninfo ====
{{Pasindispensable}}

OBSOLÈTE svn8546:03/1
3/2013

Ajoute le nom du programme au fichier journal. Très utile en cas d'utilisation du Monitor ou de l'Interface Web!
appendchaninfo = 1 # Le nom du programme est ajouté
= 0 # Aucune information (valeur par défaut)

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

==== enablelcd ====
{{Pasindispensable}}

NOUVEAU svn6285:01/23/2012

enablelcd = 0|1

0 = désactivé,
1 = activé,
par défaut = 0

==== lcd_outputpath ====
{{Pasindispensable}}

lcd_outputpath = répertoire de sortie, par défaut = /tmp

==== lcd_hideidle ====
{{Pasindispensable}}

lcd_hideidle = 0|1 (cacher reader/proxy dans la sortie lcd si inactif plus de 20s), par défaut = 0

==== lcd_writeinterval ====
{{Pasindispensable}}

lcd_writeintervall = supérieur à 5s (intervalle d'actualisation en secondes, inférieur à 5s n'est pas accepté), par défaut = 10s

=== WebIf ===
Ces paramètres sont requis uniquement si vous utilisez l'interface web

{{OScamConfWebIfParameter}}

==== Format du fichier pour envoyer des EMMs via l'interface web ====
(Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* Fichier doit être en format TXT.
* Chaque ligne doit contenir qu'un seul PRE-CAM EMM.
* Les EMMs doivent être en format HEX.
** Example : AABBCCDD...
* Des espaces ou tabulations entre des octets sont permises :
** AA BB CC DD...
* Chaque présentation d'un octet d'un EMM peu être en majuscule, en minuscule ou même mélangé :
** AA aa Aa aA...
* Toutes autres caractères ou commentaires sont interdites.

==== httpport ====
{{Obligatoire}}

Port de connexion à l'interface web.
httpport = 83 # L'interface web écoute sur le '''http-port 83'''
= +83 # L'interface web écoute sur le '''https-port 83''' (SSL)
0 # L'interface web est désactivée (valeur par défaut)

==== httpforcesslv3 ====
{{Pasindispensable}}
NOUVEAU svn:6321/01/30/2012

httpforcesslv3 = 0|1

1 = forcer l'utilisation SSLv3, par défaut = 0

==== httpcert ====
{{Pasindispensable}}

Données pour les certificats SSL-
httpcert = oscam.cert # (le voir)
= # [vide] utilisation du fichier embarqué oscam.pem

==== httpuser ====
{{Pasindispensable}}

Nom de l'utilisateur pour l'accès. Un champs [vide] est fortement déconseillé.
httpuser = # xyxyxy

==== httppwd ====
{{Pasindispensable}}

Protection par mot de passe. Il est identique à celui de l'utilisateur.
httppwd = # 123456

'''Les paramètres ''user'' et ''pwd'' sont demandés dans une fenêtre pop-up lors de la connexion à l'interface web. En cas d’erreurs ou d'oubli,la mention ''Forbidden'' (Accès interdit) apparaît et la connexion est refusée!'''

==== http_prepend_embedded_css ====
{{Pasindispensable}}
NOUVEAU svn6797:05/13/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Ne pas ajouter le contenu du CSS embarqué avant le contenu du CSS personnalisé (default)
1 # Ajouter le contenu du CSS embarqué avant le contenu du CSS personnalisé (spécifié par le paramètre [[#httpcss|httpcss]]).

Ce paramètre peut-être utilisé pour surcharger le CSS embarqué avec des styles personnalisés. Pour afficher les styles courants utilisé l'url: http://''url_to_oscam_webif'''''/site.css'''

==== httpcss ====
{{Pasindispensable}}

Différents thèmes sont disponibles pour la personnalisation de l'interface web. La personnalisation se fait à l'aide de fichiers CSS. Si vous voulez pouvoir gérer la personalisation via l'interface WebIf il faut mettre le fichier CSS (se terminant par l'extension .css) dans le répertoire contenant les fichiers de configuration d'oscam.

Exemple
httpcss = # /etc/oscam/harvest_round_Firefox.css
= # [vide] le style par défaut est utilisé (valeur par défaut)

Différents thèmes peuvent être trouvés ici: [[Streamboard-Thread:30083|Streamboard-Thread]]

==== httptpl ====
{{Pasindispensable}}

MODIFICATIONS svn 7083:06/25/2012

Chemin pour des modèles (template) externes
httptpl =
= # [vide] Pas de Templates externes e picons

Plusieurs modèles (templates) simultanés et picons peuvent être trouvé au moyen de sous-dossier peuvent être mis à disposition (avec un max. de 32 caractères alphanumérique).
Le nom du sous-dossier corresponds au sous-dossier dans l'URL, par défaut: [vide]

Exemple

httptpl = /this/is/my/path

Exemple avec plusieurs modèles:
/this/is/my/path/template1
/this/is/my/path/template2

qui donne les URLs:
http://host:port/template1
http://host:port/template2

Vous pouvez trouver plus de picons ici [[streamboard:wiki/OSCam/de/Picons|Picons]]
 
 

==== httpoverwritebakfile ====
{{Pasindispensable}}
NOUVEAU svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = écraser les fichiers de configuration de secours (*.bak)
0 = défaut
 
 

==== httplocale ====
{{Pasindispensable}}
NOUVEAU svn9828:08/15/2014

httplocale = environment

vous pouvez définir ici une variable d'environnemen "locale".

défaut = [vide] pas d'environnement

Voir ici:

http://fr.wikipedia.org/wiki/locale

==== httpjscript ====
{{Pasindispensable}}
NOUVEAU svn6806:05/14/2012

httpjscript = path

==== httprefresh ====
{{Pasindispensable}}

Délais d'actualisation de l'interface web, en secondes.
httprefresh = 7 # Actualisation toutes les 7 secondes
= # [vide] Pas d'actualisation

==== httppollrefresh ====
{{Pasindispensable}}

Paramètres de polling pour l'actualisation des données de l'interface web (le temps peut être modifié sur les pages concernées)

httppollrefresh = 60 # Le statu sera actualisé toutes les 60 secondes
= # [vide|0] aucune actualisation automatique

==== httpshowpicons ====
{{Pasindispensable}}
NOUVEAU svn6648:05/01/2012

1 = activé, par défaut = 0.

Si le paramètre est activé, alors une nouvelle colonne est ajoutée dans l'onglet USERS avec l'affichage des picons des dernières chaines regardées par les utilisateurs actifs.
Le répertoire où sont mis les picons doit être configuré dans le paramètre httppiconpath.

Les formats possible sont:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_nomdelachaine.tpl

Où pour nom de la chaînes les règles suivantes s'appliquent:

le nom de la chaîne est repris du fichier oscam.srvid ou oscam.srvid2, 
remplacer toutes les majuscule en minuscules,, 
remplacer * par le mot star, 
remplacer & par le mot and, 
remplacer + par le mot plus, 
enlever tous les caractères spéciaux et les espaces sauf a-z et 0-9, 
Si le résultat est un nom, le nom du fichier du picon sera IC_nom.tpl 

Par exemple:
service-name "BBC-ONE +HD" 
fichier picon: "IC_bbconeplushd.tpl" 
Si le service-name se terminent avec hd, et que le picon n'est pas trouvé, on essaye avec le nom dans hd, par exemple: 
fichier picon: "IC_bbconeplushd.tpl" 
-> pas trouvé, recherche pour: 
fichier picon: "IC_bbconeplus.tpl" 

==== httppiconsize ====
{{Pasindispensable}}

Défini la hauteur des picons (généralement 30 px).

==== httppiconpath ====
{{Pasindispensable}}

Défini le chemin où trouver les picons.

==== httphideidleclients ====
{{Pasindispensable}}

Permet de masquer les clients inactifs dont la durée configurée au paramètre hideclient_to est atteinte
httphideidleclients = 1 # Masquer
= 0 # Ne pas masquer (valeur par défaut)

==== httphidetype ====
{{Pasindispensable}}
NOUVEAU svn8937:09/27/2013

httphidetype = type[type]...

La lettre défini quel type de colonne doivent être cachées dans l'écran status de l'interface Web. s = serveur, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #cache les colonnes serveurs et http-type
httphidetype = [vide] # ne rien cacher (défaut)

==== httpscript ====
{{Pasindispensable}}

Chemins pour les scripts qui peuvent être démarrés à partir de l'interface web.
httpscript = # Chemin
= # [vide] aucun chemin

==== httpallowed ====
{{Obligatoire}}

MODIFICATIONS svn8733:06/27/2013

MODIFICATIONS svn8842:08/17/2013

On détermine ici l'adresse-IP ou une plage d'adresses-IP qui pourront se connecter à l'interface Web. Un [vide] est autorisé comme valeur par défaut, mais cela n'a pas de sens si on utilise l'interface Web; il faut pouvoir s'y connecter. C'est la raison pour laquelle ce paramètre est '''Obligatoire'''.

Adresse-IP|Plage d'adresses-IP[Adresse-IP|Plage d'adresses-IP[,::1]]...

Exemple
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # L'hote ainsi que la plage commençant à 192.168.0.0 sont approuvés
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # resolving to IPv6

'''défaut'''
127.0.0.1,192.168.0.0-192.255.255,10.0.0.0-10.255.255.255,::1

==== httpdyndns ====
{{Pasindispensable}}
MODIFICATIONS svn6558:03/21/12

Permet d'accéder à l'interface web à partir de l'adresse Dyndns spécifiée.

httpdyndns = hostname[,hostname][,hostname]

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

==== httpsavefullcfg ====
{{Pasindispensable}}

Sauvegarde des fichiers de configuration.

httpsavefullcfg = 0 # Tous les paramètres qui ne sont pas vides,
# Tous les paramètres n'étant pas des paramètres Par Défaut,
# Tous les paramètres qui ont une valeur différente de celle donnée dans la configuration [global] (par défaut).
1 # Tous les paramètres

==== httpreadonly ====
{{Pasindispensable}}

Certains fichiers de configuration peuvent être modifié via l'interface web. Ceci est intéressant pour l'admin du serveur qui n'a pas toujours à sa disposition une console pour l'accès au serveur. Néanmoins si d'autres utilisateurs ou intervenants peuvent bénéficier de cet accès, cela pourrait causer des problèmes. Le droit en écriture (modification) peut être désactivé par ce paramètre.
httpreadonly = 1 # accès en lecture uniquement
= 0 # tout est possible (par défaut)

==== httpiconpath ====
{{Pasindispensable}}
NOUVEAU svn:9463/01/28/2014

httpiconpath = path

path zur Picon-Datei, default [blank] none

==== httphelplang ====
{{Obligatoire}}

Permet de définir la langue utilisée dans le Wiki.
en|de|fr|it<langues disponibles dans le wiki>
en = par défaut

==== httposcamlabel ====
{{Pasindispensable}}
NOUVEAU svn9463:01/28/2014

httposcamlabel = text

setzt individuelles label im header des webinterface, default: OSCam

 
 

=== [cache] ===
{{OSCamConfCacheParameter}}

==== delay ====
{{Pasindispensable}}
NOUVEAU svn8358:02/16/2013

Délai minimum en millisecondes que peut avoir besoin une demande. Peut sembler un paradoxe, mais se rapporte au cas ou la réponse à partir du cache est transmise trop vite pour le client.

Exemple:
delay = 300

Défaut:
delay = 0

==== max_time ====
{{Pasindispensable}}
NOUVEAU svn8358:02/16/2013

max_time = seconde, défaut 15

Durée de vie maximale des CWs dans le cache après la première demande du client. La valeur doit être 2 secondes plus grandes que le paramètre clienttimeout!

==== max_hit_time ====
{{Pasindispensable}}
NOUVEAU svn8910:09/10/2013

max_hit_time = in secondes

Temps maximum, des "hits" qui doivent rester dans le cache pour évaluer le paramètre wait_time., par défault: 15

==== wait_time ====
{{Pasindispensable}}
NOUVEAU svn 8358:02/16/2013

wait_time = [caid][&mask][@provid][$servid][:awtime][:]dwtime,n
= [vide] aucun (défaut)
Exemple:
wait_time = 0:50:250,0200@00009X:50:150,15:950,0500@000001:150,1602&ffdf:1200
Le temps d'attente en millisecondes pour le cache-ex et le CSP, avant que les ECMs des Reader/Proxy ne soient envoyés.

==== cacheex_cw_check ====
{{Pasindispensable}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Pasindispensable}}

NOUVEAU svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Pasindispensable}}
NOUVEAU svn8358:02/16/2013

cacheexenablestats = 0|1

1 = schaltet statistics für cache exchange mode ein
0 = default

[[Datei:WarningS.png|text-bottom]] '''Achtung:''' Bitte Speicherverbrauch beachten!

==== csp_port ====
{{Obligatoire}}
NOUVEAU svn 8358:02/16/2013

UDP-Port, der auf hereinkommenden Traffic von csp nodes hört

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{Obligatoire}}
NOUVEAU svn 8358:02/16/2013

Local bind ip für csp_port (siehe oben)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Pasindispensable}}
NOUVEAU svn 8358:02/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid],n

Filter für hereinkommende ECM beim Cardserverproxy, default (kein Filter)

==== csp_allow_request ====
{{Pasindispensable}}
NOUVEAU svn 8358:02/16/2013

csp_allow_request = 0|1

Erlaubt hereinkommende ECM-Anfragen vom Cardserverproxy, default = 1

==== cwcycle_check_enable ====
{{Pasindispensable}}
NOUVEAU svn 8358:02/16/2013

cwcycle_check_enable = 0 ausgeschaltet (default)
= 1 eingeschaltet

==== cwcycle_check_caid ====
{{Pasindispensable}}
NOUVEAU svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention not for all NDS SC's!'''"

cwcycle_check_caid = CAID[CAID]...

CAID, für die der CW-Cycle-Check ermöglicht werden soll, [blank] = kein Check (Default)

==== cwcycle_maxlist ====
{{Pasindispensable}}
NOUVEAU svn 8358:02/16/2013

cwcycle_maxlist = Zahl

Maximum von CW-Cycle-Entries in die Liste, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Pasindispensable}}
NOUVEAU svn 8358:02/16/2013

cwcycle_keeptime = Minuten

Minimalzeit, die ein erkannter Cycle in der Memory verbleiben soll, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Pasindispensable}}
NOUVEAU svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = ungültige CW-Cycle kommen nur ins Log (default)
1 = ungültige CW-Cycle werden gedropped

==== cwcycle_dropold ====
{{Pasindispensable}}
NOUVEAU svn 8358:02/16/2013

cwcycle_dropold = 0|1, 1 = alte CW-Cycle werden gedropped, 0 = kein Dropping (default)
 
==== cwcycle_sensitive ====
{{Pasindispensable}}
NOUVEAU svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Pasindispensable}}
NOUVEAU svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Pasindispensable}}
NOUVEAU svn 9486:02/03/2014

wait_until_ctimeout = 0|1

antworte, wenn das cache exchange timeout erreicht ist und keine normalen Reader zur Verfügung stehen, die ECM's senden:

0 = sende sofort '''not found''' an den client (default)
1 = warte auf eine Antwort für cache exchange bis der timeout für den client erreicht ist

 
 

=== csp (UDP) ===
OBSOLÈTE svn8358:02/16/2013 Siehe '''[cache]'''!

Cette section est nécessaire lorsque l'échange de cache est utilisé

{{OSCamConfcspParameter}}

==== port ====
{{Obligatoire}}
NOUVEAU svn 6124:12/23/2011

Port UDP du CSP pour l'échange du cache.

port = port
= [rien] aucun (par défaut)

==== serverip ====
{{Obligatoire}}
NOUVEAU svn 6124:12/23/2011

Adresse IP du CSP pour l'échange du cache.

serverip = IP
= [rien] aucun (par défaut)

==== wait_time ====
{{Obligatoire}}
NOUVEAU svn 6142:12/25/2011

Quand la valeur est supérieure à 0 (> 0), chaque demande d'ECM attend ce temps avant d'envoyer la demande aux readers

wait_time = en millisecondes
= [rien] aucun (par défaut)

==== csp_ecm_filter ====
{{Pasindispensable}}

csp_ecm_filter = [caid][&mask][@provid][$servid],n
= [rien] (par défaut)

==== csp_allow_request ====
{{Pasindispensable}}

csp_allow_request = 0|1
= 1 (par defaut)

=== Camd 33 (TCP) ===
Cette section est nécessaire, uniquement lors de l'utilisation du protocole Camd 33.

{{OSCamConfCamd33Parameter}}

==== port ====
{{Obligatoire}}
On détermine ici le port, sur lequel Camd 33 écoute et répond aux demandes. Il peut être nécessaire d'effectuer sur le router une redirection vers ce port.

Exemple:
port = 15000

==== serverip ====
{{Pasindispensable}}
Sur un serveur comportant plusieurs cartes réseau différentes et par conséquent plusieurs adresses IP, il peut être souhaitable que Oscam ne réponde que si la demande arrive via une adresse IP précise. Avec ce paramètre, vous déterminez sur quelle adresse IP Oscam "écoute".

Exemple:
serverip = 192.168.178.1

Par défaut:
serverip =

==== nocrypt ====
{{Pasindispensable}}
Détermine une adresse IP ou une plage d'adresses IP ne requérant pas de connexions cryptées

Exemple:
nocrypt = 127.0.0.1,192.168.0.0-192.168.255.255

Par défaut:
nocrypt =

==== passive ====
{{Pasindispensable}}
Définition des clients actifs ou passifs. En général le protocole Camd 33 émane d'un client actif. Dans certaines circonstances, chez certains clients (principalement les plugins) pdes problèmes peuvent apparaître. Dans ce cas on utilise

Exemple:
passive = 1

Par défaut:
passive = 0

==== key ====
{{Pasindispensable}}

Clé utilisée pour le chiffrement. (128bits)

Exemple:
key = 01020304050607080910111213141516

Par défaut:
key =

=== cs357x (UDP) ===
Cette section est nécessaire lorsque le protocole cs357x est utilisé.
Dans ce protocole, le nom d'utilisateur sert de base au chiffrement.

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
'''cs357x''' était aussi connu comme '''camd35''' dans les anciennes versions. Les deux termes correspondent au même protocole avec les mêmes fonctions et paramètres. Dans l'avenir, pour éviter toute confusion '''uniquement cs357x''' est utilisé.

{{OSCamConfCs357xParameter}}

==== port ====
{{Obligatoire}}
On détermine ici le port, sur lequel Camd écoute et répond aux demandes. Il peut être nécessaire d'effectuer sur le router une redirection vers ce port. '''Attention, il s'agit d'un port UDP'''.

Exemple:
port = 15000

==== serverip ====
{{Pasindispensable}}
Sur un serveur comportant plusieurs cartes réseau différentes et par conséquent plusieurs adresses IP, il peut être souhaitable que Oscam ne réponde que si la demande arrive via une adresse IP précise. Avec ce paramètre, vous déterminez sur quelle adresse IP Oscam "écoute".

Exemple:
serverip = 192.168.178.1

Par défaut:
serverip =

==== suppresscmd08 ====
{{Pasindispensable}}

suppresscmd08 = 0|1
Dire aux clients camd35|cs357x de ne pas faire à nouveau des demandes pour les CAID, ServiceID et providerID qui sont déjà rejetés. 1 = désactivé, défaut = 0

Si vous voulez en savoir plus à ce sujet cliquez sur le lien suivant : [[Streamboard-Thread:27459|Streamboard-Thread]]

=== cs378x (TCP) ===
Cette section est nécessaire quand le protocole cs378x est utilisé.

{{OSCamConfCs378xParameter}}

==== port ====
{{Obligatoire}}
Port(s) sur le(s)quel(s) Cs378x (Camd 3.5 en mode TCP) écoute et répond aux demandes. Il peut être nécessaire d'effectuer sur le router une redirection vers ce port.

port@CAID[:ident][,ident]...[;port@CAID[:ident][,ident]...]...

Exemple:
port = 15000@0500:030B00;22764@0648

==== serverip ====
{{Pasindispensable}}
Dans le cas d'un serveur comportant plusieurs cartes réseau et donc plusieurs adresses IP différentes, il peut être souhaitable que Oscam ne réponde que si la demande arrive à une adresse IP bien déterminée. Avec ce paramètre, vous pouvez spécifier quelle adresse IP oscam "écoute" . .

Exemple:
serverip = 192.168.178.1

Par défaut:
serverip =

==== suppresscmd08 ====
{{Pasindispensable}}

suppresscmd08 = 0|1

suppresscmd08 = 0|1
Dire aux clients 3.78x de ne pas faire à nouveau des demandes pour les CAID, ServiceID et providerID qui sont déjà rejetés. 1 = désactivé, défaut = 0

Si vous voulez en savoir plus à ce sujet lisez ceci: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== Newcamd (TCP) ===
Cette section est nécessaire si le protocole newcamd est utilisé.

{{OSCamConfNewcamdParameter}}

==== key ====
{{Obligatoire}}
Des key pour la connexion newcamd.

Exemple:
key = 0102030405060708091011121314

Par défaut:
key =

==== port ====
{{Obligatoire}}
On détermine ici le port, sur lequel newcamd écoute et répond aux demandes. Il peut être nécessaire d'effectuer sur le router une redirection vers ce port.. .

Exemple:
port = 15000@1234:000000 # (les requètes pour le CAID 1234 seront effectuées via le Port 15000 )
port = 15000@1234:000000;15001@5678:000000 # (les requètes pour le CAID 1234 seront effectuées via le Port 15000 rt pour le CAID 5678 via le Port 15001)

Par défaut:
port = port@caid:ident

==== serverip ====
{{Pasindispensable}}
Dans le cas d'un serveur comportant plusieurs cartes réseau et donc plusieurs adresses IP différentes, il peut être souhaitable que Oscam ne réponde que si la demande arrive à une adresse IP bien déterminée. Avec ce paramètre, vous pouvez spécifier sur quelle adresse IP oscam "écoute" .

Exemple:
serverip = 192.168.178.1

Par défaut:
serverip =

==== allowed ====
{{Pasindispensable}}
La connexion au serveur newcamd est autorisée à partir d'une adresse spécifique ou d'une plage d'adresses.

Exemple:
allowed = 127.0.0.1,192.168.0.0-192.168.255.255

Par défaut:
allowed =

==== keepalive ====
{{Pasindispensable}}
Le serveur tente de garder la connexion newcamd active.

Exemple:
keepalive = 1 # (activé)
keepalive = 0 # (désactivé)

Par défaut:
keepalive = 0

==== mgclient ====
{{Pasindispensable}}
Le protocole newcamd étendu est activé pour transmettre plusieurs caid sur un même port

Exemple:
mgclient = 1 # (activé)
mgclient = 0 # (désactivé)

Par défaut:
mgclient = 0
 
 
=== '''scam''' ===

NOUVEAU svn9878:09/29/2014

Abschnitt nur dann erforderlich, wenn scam als Client-Protocol verwendet wird.

{{OSCamConfSCamParameter}}

==== port ====
{{Obligatoire}}

port = port

UDP-Port für scam server, default = 0

==== serverip ====
{{Pasindispensable}}

Lie le service à une adresse IP déterminée sur un serveur comportant plusieurs cartes réseaux.

Exemple:
serverip = 192.162.9.1
= (vide) écoute sur toutes les adresses!

==== allowed ====
{{Pasindispensable}}

Adresse IP, Plage d'adresses ou les deux, qui sont autorisées
Adresse IP|Plage d'adresses[,Adresse IP|Plage d'adresses]...

Exemple
127.0.0.1,192.168.0.0-192.168.255.255 # Hôte et la plage commençant 192.168.0 sont acceptées
 
 

=== Radegast ===
Cette section est nécessaire si le protocole Radegast est utilisé.

{{OSCamConfRadegastParameter}}

==== port ====
{{Obligatoire}}

Port TCP/IP pour les client Radegast. '''Cette entrée active le protocole.'''
port =
= 0 (valeur par défaut)

==== serverip ====
{{Pasindispensable}}

Lie le service à une adresse IP déterminée sur un serveur comportant plusieurs cartes réseaux.

Exemple:
serverip = 192.162.9.1
= (vide) écoute sur toutes les adresses!

==== allowed ====
{{Pasindispensable}}

Adresse IP, Plage d'adresses ou les deux, qui sont autorisées
Adresse IP|Plage d'adresses[,Adresse IP|Plage d'adresses]...

Exemple
127.0.0.1,192.168.0.0-192.168.255.255 # Hôte et la plage commençant 192.168.0 sont acceptées

==== user ====
{{Obligatoire}}

Nom d'utilisateur du Client
user = username

=== Serial ===
Cette section est nécessaire lorsqu'un Reader série est utilisé.

{{OSCamConfSerialParameter}}

==== device ====
{{Pasindispensable}}

Paramètres du Reader
device = <user>@<device>[:baud][?option1=valeur1][?option2=v]aleur2

Paramètres
user = account
device = Nom du Device série
option = timeout = délai en millisecondes Timeout pour la connection par défaut: 50
= delay délai supplémentaire en millisecondes en dux caractères
Reader séries supportés
HSIC Humax Sharing Interface Client
SSSP Simple Serial Sharing Protocol
bomba BOMBA Firmware
dsr9500 DSR 9500

=== Cccam (TCP) ===
Cette section est nécessiare si le protocole CCcam est utilisé

{{OSCamConfCccamParameter}}

==== port ====
{{Obligatoire}}

MODIFICATIONS svn6206:01/07/2012

Ports TCP/IP pour les clients CCcam. '''Si ce paramètre est défini, cela activera le protocole CCcam!'''

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

port =
= 0 # Protocole CCcam désactivé

==== version ====
{{Pasindispensable}}

Définit la version de CCcam, minimum CCcam version 2.0.11 '''0riginal CCcam''' Par défaut = 0
<nowiki><main version>,<version>,</nowiki>

Exemple
version = 2.0.11

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

==== reshare ====
{{Pasindispensable}}

MODIFICATIONS svn8607:04/10/2013

Niveau de repartage pour les clients CCcam
-1 = aucun repartage
0 = repartage pour les clients directs
1 = repartage pour les clients directs et 1 niveau supplémentaire
x = repartage pour les clients directs et x niveau(s) supplémentaire(s) (x correspond au nombre de niveau)
10 = (default)

Exemple
reshare = 1 # repartage seulement pour le client direct

==== reshare_mode ====
{{Pasindispensable}}

Mode de repartage:
0 = readerne ne repartage que les SCs reçus du reader CCcam
1 = reader ne repartage que les SCs reçus ( comme 0) et les services définis
2 = reader ne repartage que les services définis comme SC virtuelle
3 = reader ne repartage que les services utilisateurs définis comme SC virtuelle

==== ignorereshare ====
{{Pasindispensable}}

Paramètre de repartage CCcam
0 = utilise le paramètre de repartage du serveur (par défaut)
1 = utilise le paramètre de repartage du lecteur ou utilisateur

Exemple
ignorereshare = 1 # le paramètre de repartage du lecteur ou utilisateur est utilisé

==== stealth ====
{{Pasindispensable}}
Agit comme un CCcam originel. Empèche les autres utilisateurs de découvrir que le serveur est un serveur oscam
stealth = 1 # Camouflage activé
= 0 # Camouflage désactivé (valeur par défaut)

==== minimizecards ====
{{Pasindispensable}}

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

''à compléter''

==== updateinterval ====
{{Pasindispensable}}

Temps (en secondes) pour fournir la liste des partages aux clients CCcam
0 = mise à jour basée sur les mises à jours serveur, values <= 10 are invalid and will be set to 30
= [rien] 240 (par défaut)

==== keepconnected ====
{{Pasindispensable}}

Définit le mode keepalive de CCcam:
0 = déconnecte le client lorsque le max idle time est atteint
1 = garde le client connecté (par défaut)

==== forward_origin_card ====
{{Pasindispensable}}

forward_origin_card = 0|1
0 = désactivé (par défaut)
1 = activé

[[Datei:WarningS.png|text-bottom]] '''ATTENTION:'''
Ce paramètre est pour ceux qui veulent transmettre les demandes d'ECM des clients au lecteur possédant cette carte. L'activation de cette option désactive le loadbalancer, la fonction fallback et une partie du cache.
Si vous n'avez pas compris ce que cette option fait, ne l'utilisez pas.

==== recv_timeout ====
{{Pasindispensable}}
NOUVEAU svn7672:10/09/2012

recv_timeout = Millisekunden

hier kann ein network-timeout beim Empfang von Daten gesetzt werden
default = 2000

==== nodeid ====
{{Pasindispensable}}

nodeid =

Le nodeid est configurable maintenant (en hex).

Exemple: nodeid = 0A0B0C0D0E0F1122
 
 
=== 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 ===
NOUVEAU svn8350:02/15/2013
{{OScamConfGboxParameter}}

 
'''Beispiel einer funktionierenden Minimal-Konfiguration:'''

Angenommen die GBox läuft auf Host 192.168.1.101 und OSCam liegt auf 192.168.1.123. Im File '''cwshare.cfg''' auf der GBox-Seite stehen z.B. folgende Eintragungen:
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
Dann sieht die Konfiguration auf OSCam so aus:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
[reader]
protocol = gbox
group = 1
device = 192.168.1.101,3820,3819
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{Obligatoire}}

NOUVEAU svn9163:12/31/2013
'''moved from oscam.server'''

MODIFICATIONS svn9494:02/04/2014
 

Passwort = 4 hex bytes, 8 chara

Mein Passwort

Beispiel
98AF3E25

 

==== proxy_card ====
{{Pasindispensable}}
NOUVEAU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s), die mit gbox network reshared werden, default = none

 

==== ccc_reshare ====
{{Pasindispensable}}
NOUVEAU svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{Obligatoire}}
MODIFICATIONS svn9494:02/04/2014

hostname = eigene IP oder hostname

 

==== port ====
{{Obligatoire}}

port[,port]... eigener Gbox port

 

==== my_vers ====
{{Pasindispensable}}
NOUVEAU svn9645:04/09/2014

my_vers = version

hier kann die gbox-version in hexadezimal low byte gesetzt werden

default = 25

 

==== my_cpu_api ====
{{Pasindispensable}}
NOUVEAU svn9712:05/11/2014

my-cpu_api = byte

Setze CPU und API Byte in hexadecimal
default = 40

 

==== gbox_reconnect ====
{{Pasindispensable}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Pasindispensable}}
NOUVEAU svn9714:05/11/2014

gsms_disable = 0|1

schaltet gbox short message service (GSMS) aus,
default = 0

 
 
==== tmp_dir ====
{{Pasindispensable}}
NOUVEAU svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox
 
 

=== DVBapi ===
{{Pasindispensable}}
Cette section est nécessaire quand OSCam est également utilisé comme client pour le décryptage!

{{OSCamConfDVBapiParameter}}

==== enabled ====
{{Pasindispensable}}
Le DVBapi est utilisé pour le décryptage local

Exemple:
enabled = 0 # (désactivé)
enabled = 1 # (activé)

Par défaut:
enabled = 0

==== user ====
{{Obligatoire}}
On indique ici l'utilisateur défini dans le oscam.user

Exemple:
user = # user1

Par défaut:
enabled = # anonymous

==== au ====
{{Pasindispensable}}
Activation de l'Autoupdate (mise à jour des droits) pour le DVBAPI.
Dépens des réglages déterminés pour l'utilisateur dans l'oscam.user

Exemple:
au = 0 # désactivé (default)
au = 1 # activé

==== pmt_mode ====
{{Pasindispensable}}

Défini le mode de communication entre OScam et votre récepteur. Les modes possibles peuvent aussi être lié à l'image installée sur votre récepteur. Par exemple, le mode 6 est pour l'image OpenPLi et dérivées.

Exemple:
pmt_mode = 0 # (utilise le camd.socket et le fichier PMT )
pmt_mode = 1 # (désactive le fichier PMT )
pmt_mode = 2 # (désactive le camd.socket)
pmt_mode = 3 # (lit le fichier PMT seulement au démarrage)
pmt_mode = 4 # n'utilise pas le gestionnaire de signaux pour la surveillance /tmp
pmt_mode = 5 # n'utilise pas le gestionnaire de signaux pour la surveillance /tmp & désactive le camd.socket
pmt_mode = 6 # utilise le CA PMT mode serveur. (nouveau en SVN 8680)
Par défaut:
pmt_mode = 0

==== request_mode ====
{{Pasindispensable}}

Mode de requete des CAID:

Exemple:
request_mode = 0 # essaye tous les CAIDs un par un, valeur par défaut
request_mode = 1 # essaye tous les CAIDs simultanément

==== listen_port ====
{{Pasindispensable}}

NOUVEAU svn9574:03/20/2014

listen_port = 0|1

Port TCP IP pour les clients IP par satellite. Le filtrage doit être fait côté client!

0 = disabled (default)

==== boxtype ====
{{Obligatoire}}
Indique au DVBAPI le type de décodeur utilisé

Exemple:
boxtype = ufs910
boxtype = dbox2|dreambox|dm7000|duckbox|ufs910|ipbox|ipbox-pmt|qboxhd|coolstream|neumo|pc

Par défaut:
boxtype = dreambox

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

==== cw_delay ====
{{Pasindispensable}}
NOUVEAU svn6348:02/05/2012

cw_delay = millisecondes

Retard à l'écriture des CW, par défaut = [vide] (aucun retard)

==== delayer ====
{{Pasindispensable}}
NOUVEAU svn6808:05/14/2012

delayer = millisecondes

Temps minimum pour écrire CW, un retardateur pour éviter la pixellisation sur les réponses rapides, par défaut = 0

==== reopenonzap ====
{{Pasindispensable}}
OBSOLÈTE svn9072:12/08/2013

reopenonzap = 0|1

1 = rouvrir dispositifs demux sur chaque changement de canal, par défaut = 0

==== decodeforever ====
{{Pasindispensable}}
OBSOLÈTE svn8680:06/05/2013

decodeforever = 0|1

1 = Cherche à décoder en permanence tous les CAIDs
0 = Par défaut

==== ecminfo_type ====
{{Pasindispensable}}
NEW svn10722:06/13/15

Défini le type de fichier ecm.info à créer, ecminfo_type = 0|1|2|3|4|5

0 = syntaxe oscam par défaut
1 = syntaxe oscam avec l'ecmtime en ms à la place de s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== ecminfo_hide_ms_name ====
{{Pasindispensable}}
Nouveau svn10760:06/15/15
OBSOLÈTE svn10799:06/24/2015

ecminfo_hide_ms_name = 0|1

1 = ne pas ajouter ms à l'information '''ecm time''' dans le fichier ecm.info (par défault)
0 = ajouter ms à l'information '''ecm time''' dans le fichier ecm.info

==== read_sdt ====
{{Pasindispensable}}
Nouveau svn10766:06/15/15

Cette option ajoute automatiquement les informations dans votre oscam.srvid2 et votre oscam.provid si elle n'existe pas encore. Vous devez rester '''plus de 30 secondes''' pour que l'autodetection démarre. Ensuite tant le nom de la chaîne que celui du fournisseur seront retrouvés. Il n'y a pas de mise à jour des informations si elles existent déjà, vous gardez le contrôle du contenu de votre oscam.srvid2 et oscam.provid.

read_sdt = 0|1

0 = désactivé (par défaut)
1 = activé mais ne sauvegarde pas les chaînes en clair (FTA)
2 = activé et sauvegarde aussi les chaînes en clair (FTA)

==== write_sdt_prov ====
{{Pasindispensable}}
Nouveau svn10841:27/06/15

Il faut au préalable avoir activé le paramètre read_sdt (Detect channel name) ensuite vous pouvez spécifier si le nom du fournisseur est sauvegardé dans le fichier oscam.srvid[2]. Ceci n'est pas obligatoire étant donné que l'information sur le fournisseur est retrouvé depuis le fichier oscam.provid.

write_sdt_prov = 0|1

0 = désactivé, ne pas écrire le nom du fournisseur dans le fichier oscam.srvid[2] (par défaut)
1 = activé écrit le nom du fournisseur dans le fichier oscam.srvid[2]

=== Anticasc ===
Cette section est nécessaire si on veut utiliser l' Anticascading pour éviter le repartage non autorisé de la carte.

{{OSCamConfAnticascParameter}}

==== enabled ====
{{Obligatoire}}

Activation de l'Anticascading.
enabled = 0 # désactivé (valeur par défaut)
= 1 # activé

==== numusers ====
{{Pasindispensable}}
Nombre d'utilisateurs pris en compte pour le calcul des ecms
numusers = 0 # Anticascading désactivé (valeur par défaut)
= 1 # Un utilisateur ==> (1*100+80)/(10*100/60) = 11 ecms autorisés par minute
= 2 # Deux utilisateurs ==> (2*100+80)/(10*100/60) = 17 ecms autorisés par minute 
10 = chiffre mis dans oscam.ac. Par defaut c'est 10

==== sampletime ====
{{Pasindispensable}}
Temps en Minutes pour le comptage du nombre d'ecms,
(ne doit pas être inférieur a 0 car sinon oscam lui donne la valeur 2)

sampletime = # Période de 2 minutes (valeur par défaut)
= 5 # Période de 5 minutes

Ex: numusers = 1 ==> 11 ecms * 5 minutes ==> 55 ecms maxi en 5 minutes
numusers = 2 ==> 17 ecms * 5 minutes ==> 85 ecms maxi en 5 minutes

==== samples ====
{{Pasindispensable}}
Nombre d' ecms supplémentaires autorisées pour affiner le réglage
(doit être compris entre 2 et 10 sinon oscam lui donne la valeur de 10)

samples = # On autorise 10 ecms supplémentaires(valeur par defaut)
= 3 # On autorise 3 ecms supplémentaires

==== penalty ====
{{Pasindispensable}}
Sanction pour l'utilisateur en faute (ne doit pas être inférieur à 0 sinon Oscam lui donne la valeur 0)

0 = Uniquement loging (valeur par défaut)
1 = Des Faux DW's sont envoyés
2 = L'utilisateur est temporairement banni
3 = Des vrais DW's sont envoyés mais avec un délai ([[OSCam/fr/Config/oscam.conf#fakedelay|fakedelay]])

La sanction peut être redéfinie par utilisateur dans oscam.user!

==== aclogfile ====
{{Pasindispensable}}
Fichier log pour l'Anticascading
<pre>aclogfile = # [vide] pas de fichier log (valeur par défaut)
= /var/log/aclogfile # Fichier dans /var/log (on peut mettre un autre endroit bien sur)</pre>

==== fakedelay ====
{{Pasindispensable}}
Délai d'envois de faux CW en Millisecondes (doit être compris entre 100 et 3000 sinon Oscam lui donne la valeur de 1000)

fakedelay = # 1000 Millisecondes (valeur par défaut)
= 500 # délai de 500 Millisecondes

==== denysamples ====
{{Pasindispensable}}
Calcul du temps en minutes d envoi des faux DW's suivant la formule ==> sampletime * denysamples
 S'applique uniquement avec penalty = 1 ou 3 et se calcule avec la valeur de sampletime

<pre>denysamples = # [vide] Des faux DW's sont envoyes pendant sampletime * 8 (valeur par défaut)
= 4 # Si sampletime = 5 ==> Des faux DW's sont envoyes pendant 20 minutes (5 * 4)</pre>

 
==== acosc_enabled ====
{{Pasindispensable}}
NOUVEAU svn9761:06/05/14

'''Vorbemerkung:'''
mit den nachfolgenden acosc-Parametern wir ein Anticascading über das Zählen der SIDs ('''a'''nticascading '''o'''ver '''s'''id '''c'''ount) ermöglicht.
 
acosc_enabled = 0|1
1 = ermöglicht anticascading over SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Pasindispensable}}
NOUVEAU svn9761:06/05/14

acosc_max_active_sids = Anzahl

Maximum aktiver SIDs bei Anticascading over SIDs count

0 = unbegrenzt (default)
kann für jeden User in der jeweiligen oscam.user überschrieben werden!

 

==== acosc_zap_limit ====
{{Pasindispensable}}
NOUVEAU svn9761:06/05/14

acosc_zap_limit = Anzahl

Zap-Limit bei Anticascading over SIDs count

0 = unbegrenzt (default)
kann für jeden User in der jeweiligen oscam.user überschrieben werden
 

==== acosc_penalty ====
{{Pasindispensable}}
NOUVEA svn9761:06/05/14

acosc_penalty = 0|1|2|3

Strafe für den Sünder bei Anticascading over SIDs count:
0 = Es wird nur geloggt (default)
1 = Es werden Fake-CW's gesendet
2 = Der User wird vorübergehend getrennt
3 = Sende korrekte CWs zeitversetzt. Der Versatz ist per fakedelay= (s.u.) einstellbar.
kann für jeden User in der jeweiligen oscam.user überschrieben werden
 

==== acosc_penalty_duration ====
{{Pasindispensable}}
NOUVEAU svn9761:06/05/14

acosc_penalty_duration = Sekunden

Dauer der Strafe bei Anticascading over SIDs count:

0 = unbegrenzt (default)
kann für jeden User in der jeweiligen oscam.user überschrieben werden
 

==== acosc_delay ====
{{Pasindispensable}}
NOUVEAU svn9761:06/05/14

acosc_delay = Millisekunden

Verzögerung bei Anticascading over SIDs count

0 = unbegrenzt (default)
kann für jeden User in der jeweiligen oscam.user überschrieben werden
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2017-01-01T01:39:05Z

Pr2: /* cs378x (TCP) */ correct typo

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

==== httpshowmeminfo ====
{{Optional/en}}

httpshowmeminfo = 0|1
1 = display memory usage informations in Status screen
0 = do not show (default)

==== httpshowloadinfo ====
{{Optional/en}}

httpshowloadinfo = 0|1
1 = display load average and CPU usage informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== cs378x (TCP) ===
Section required only if cs378x (camd 3.5x in TCP) will be used as client protocol!

{{OSCamConfCs378xParameter}}

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

Port(s) TCP for Cs378x clients (camd 3.5x in TCP mode). Port(s) must be opened at router!

port@CAID[:ident][,ident]...[;port@CAID[:ident][,ident]...]...

Example:
port = 15000@0500:030B00;22764@0648

==== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port= define incoming UDP port(s) used by Gbox protocol

port= port#1[[,port#2]...[,port#32]]

Maximum 32 ports.

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2017-01-01T01:36:53Z

Pr2: /* cs378x (TCP) */ Give correct information about port capabilities.

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

==== httpshowmeminfo ====
{{Optional/en}}

httpshowmeminfo = 0|1
1 = display memory usage informations in Status screen
0 = do not show (default)

==== httpshowloadinfo ====
{{Optional/en}}

httpshowloadinfo = 0|1
1 = display load average and CPU usage informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

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

{{OSCamConfCs378xParameter}}

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

Port(s) TCP for Cs378x clients (camd 3.5x in TCP mode). Port(s) must be opened at router!

port@CAID[:ident][,ident]...[;port@CAID[:ident][,ident]...]...

Example:
port = 15000@0500:030B00;22764@0648

==== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port= define incoming UDP port(s) used by Gbox protocol

port= port#1[[,port#2]...[,port#32]]

Maximum 32 ports.

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2016-12-23T10:56:48Z

Pr2: /* port */

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

==== httpshowmeminfo ====
{{Optional/en}}

httpshowmeminfo = 0|1
1 = display memory usage informations in Status screen
0 = do not show (default)

==== httpshowloadinfo ====
{{Optional/en}}

httpshowloadinfo = 0|1
1 = display load average and CPU usage informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port= define incoming UDP port(s) used by Gbox protocol

port= port#1[[,port#2]...[,port#32]]

Maximum 32 ports.

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2016-12-23T10:55:43Z

Pr2: /* port */ Improve Gbox port explanations

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

==== httpshowmeminfo ====
{{Optional/en}}

httpshowmeminfo = 0|1
1 = display memory usage informations in Status screen
0 = do not show (default)

==== httpshowloadinfo ====
{{Optional/en}}

httpshowloadinfo = 0|1
1 = display load average and CPU usage informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port= define incoming UDP port(s) used by Gbox protocol

port= port#1[,port#2]...[,port#32]]

Maximum 32 ports.

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.server

2016-12-21T13:37:39Z

Pr2: /* [reader] */ Add DRE parameters

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

== oscam.server ==
The server configuration file for OSCam contains reader parameters. Sections in oscam.server are recurring (more than one reader possible). At least one [reader] section is required. Examples for reader configuation you will find here [[OSCam/en/examples/Reader|example configurations]]

{{OSCamServerParameter}}

=== [reader] ===
Define local or remote reader

==== label ====
{{required}}

name for reader

Example:
label = easymouse2

==== enable ====
{{Optional/en}}
deactivate reader
0 = off
1 = On (default)

==== description ====
{{Optional/en}}

description = text

description of reader, default: [blank] none

==== protocol ====
{{required}}

reader protocol
protocol = mouse (local cardreader)
= internal (all cardreader with "device=/dev/sciX", and internal Coolstream-Reader)
= camd35|cs357x (cascading - camd 3.5-compatible remote server - udp)
= mp35
= smartreader
= serial
= cs378x (camd 3.5-compatible remote server - tcp)
= gbox
= newcamd|newcamd525
= newcamd524
= cccam
= radegast
= pcsc
= constcw
= sc8in1
= smargo

==== device ====
{{required}}

CHANGE svn8057+8059:01/04/2013

CHANGE svn8096:01/13/2013

CHANGE svn8911:09/10/2013

define local or remote reader

device = [<readertype>;]serial:serialnum|bus:device|<device|device:slot>|<ip|hostname>,<port>[,<lport>]|pcsc|<0|1>>|constantcw

set reader type

readertype:
SR: Smartreader+ (default)
SRv2: Smartreader V2
Infinity: Infinity USB
TripleP1: Smargo Triple Reader port 1
TripleP2: Smargo Triple Reader port 2
TripleP3: Smargo Triple Reader port 3

bus:device: bus name and device name of the smartreader+
(get the name with lsusb 'Bus' ans 'Device')

serialnum: Serial-Nummer des Smartreader+ or Ininity USB (get the serial number while starting OSCam)

device: device name

device:slot: device name and slot number sc8in1 /1-8)
(only one sc8in1 reader supported)

ip|hostname: IP address or host name

port: TCP/IP port

lport: remapping to local TCP/IP port

PCSC: number of PCSC reader, starting with 0

0|1: ''' for Coolstream HD-1 STB only''': select reader 0 or reader 1

constantcw: constant CW file name

CW-File-Format:
'''Standard'''
CAID:Provider ID:Service ID:PMT ID:ECM PID::key (16 Bytes seperated by spaces)
example:
1234:123456:1234:2345:3456::00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

'''Extended OSCam-Format'''
CAID:Provider ID:Service ID:PMT ID:ECM PID:Video PID:key (16 Bytes seperated by spaces)
example:
1234:123456:1234:2345:3456:7890:00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

Examples for device parameters
device = /dev/ttyS0 # (Reader on COM1 (Linux i386 and Windows))
device = /dev/tts/1 # (Reader on COM2 (Linux dbox2 with multicam))
device = /dev/ttyUSB0 # (Reader on USB (Linux i386))
device = /dev/ttyUSB0:1 # Slot 1 SC8in1 or MCR 4/8 (Linux i386)

'''Attention:''' Counting begins with 0, that means number of device is one less than number of COM-Port! Eg ttyS0 = COM1, tts/1 = COM2.

==== detect ====
{{Depends/en}}

status detect of card '''is in'''
analysis by fun7:

Detect = CD - Carrier Detect, is a line that is used by the switch (open / closes a circuit)
for '''protocol = mouse'''
'''default'''

Detect = DSR - Data Set Ready: is a V24 / (RS232) interface signal that is transmitted on PIN 6 of a D-SUB connector.
I guess the detection itself has to be processed by the cardreaders ICs itself and is later on beeing
transmitted on pin6.

Detect = CTS - Clear To Send) - RTS - Ready to send : A RTS (ready to send) request is beeing send out from the reader.
Usually the oscam will answer with a '''CTS''' (clear to send) response, telling its ready to receive.
That feature had a common use on analog modems in the past.

Detect = RING - Ring Indicator: this describes a so called RING indicator - like the ring of a telephone - that is specified
in the RS232 specs to signalize an incoming call. In the context of oscam this should mean: reader is ringing
the oscam after card insertion, telling the oscam its desire to create a data connection. Like the word "ring"
indicates, this was used in serial connections of modems as well.

Detect = NONE - detect switched off, but signal "card is in"

Detect = GPIO - GPIO means "general purpose input output". Used for '''mipsel-uclib''', I could imagine this could be useful if
you want to play around with a '''raspberry pi''' and transmit the cardstatus to its gpio pin.
[gpio1,...gpio7]

* Inverse = prefix "!"(eg "detect=!CTS")

example
[reader]
label = mymouse
description = mymouse xxx
'''protocol = mouse'''
device = /dev/ttyUSB0 (easymouse 2)
services = xxx
boxkey = 1122334455667788
force_irdeto = 1
'''detect = cd'''
mhz = 1000
cardmhz = 600
group = 1,2,3
emmcache = 1,3,2

==== cardmhz ====
{{Depends/en}}
CHANGE svn7046:06/12/12

set standard SC frequency in units of 10 kHz, for Irdeto SC set to 600, refer to [[OSCam/en/examples/Overclocking|Overclocking]]
Example:
cardmhz = 600 # Irdeto card
= # [blank] 357 (default)

'''INTERNAL READERS'''

If you use cardmhz >2000 OScam will switch to PLL clocking. Internal readers of boxes from Dream Multimedia GmbH can be clocked more precise with it.

The used cardmhz should reflect the highest frequency of the PLL crystal in the internal cardreader. OSCam will calculate the best PLL divider that comes nearest to the wanted user card speed specified in cardmhz.

Use the following settings:

Models with PPC-CPU (DM500/DM600/DM7000/DM7020) use "cardmhz = 3150"

Models with MIPS-CPU (DM500HD/DM800/DM800SE/DM8k/DM7020HD etc.) use "cardmhz = 2700"

DM7025 is special, use "cardmhz = 8300"

'''If only the parameter cardmhz is set (without mhz = xxx) then Oscam clocks the card automatically with the ATR! '''

E.G. You have a dream 800 HD PVR, thats a mips so you should set cardmhz to 2700. We got a nagra card that should run on 5 MHz. If

you want to clock the card ok just use cardmhz = 2700 an mhz = 500. If you want to overclock it use cardmhz = 2700 and mhz = 900.

Now your card will start to run 9 Mhz. Better monitor it! An overclocked card could run hot or crash suddenly!

Keep in mind that most internal readers of non-dreamboxes clock the cards automatically and copletely ignore any user clockspeed setting. But you should set cardmhz and mhz anyway, as its still used to calculate the correct timings in OSCam. If you set cardmhz/mhz correct the timings will better match with the actual (automatically) clockspeed of the internal card reader. As for a result slighly better ecm responses or more stable functioning.

Dont expect magic here, only overclocking the cardspeed can reduce the ecm response time. Bad timings can only delay it or make the card responses instable!
[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== mhz ====
{{Optional/en}}
CHANGE svn 9064:12/13/2013

set reader frequency in units of 10 kHz, if mhz > cardmhz you are in overclocking mode, refer to [[OSCam/en/examples/Overclocking|Overclocking]]

Example:
# Default 357
cardmhz = 600 # ( 6000 KHz = 6 MHz)
mhz = 1000 # (10000 KHz = 10 MHz)

auto clock speed in '''Dreambox mode''' set to -1. Further Informations about the various (Dream)Boxes can be found [http://www.streamboard.tv/oscam/wiki/ReaderClocks here].

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== autospeed ====
{{Optional/en}}
NEW svn9064:12/01/2013

autospeed = 0|1

autospeed = 0 disabled
autospeed = 1 (default) Sets mhz according to ATR. Currently only used for smartreader, smargo protocol and Dreambox-readers internal protocol. Other readers will be adapted to use this
parameter as well. In webif checked means 1. If you want to overclock your card set autospeed to 0.

==== deprecated ====
{{Optional/en}}
First the SC will be initialized in normal mode. If it fails, the SC will be automatically reverted to deprecated mode, so that the SC speed will not be changed and the communication will remain on normal ATR speed of 9600 baud.

deprecated = 1 use deprecated SC mode only
= 0 default

==== mode ====
{{Depends/en}}
set card init mode for '''AzBox''' reader
mode = 1 # AzBox-Reader
= 0 # none (default)

==== device_out_endpoint ====
{{Depends/en}}

CHANGE svn8013:12/29/2012

set endpoint address for FTDI chips
device_out_endpoint = 0x81 # Smargo Triple Reader port 1
= 0x82 # Smartreader+ (default)
= 0x83 # Smargo Triple Reader port 2
= 0x85 # Smargo Triple Reader port 3

==== smargopatch ====
{{Optional/en}}
NEW svn6402:02/16/2012

smargopatch = 0|1

enable workaround for smartreader+ and reader until native mode works, default = 0

==== sc8in1_dtrrts_patch ====
{{Optional/en}}
NEW svn6402:02/16/2012

sc8in1_dtrrts_patch = 0|1

enable fix for SC8in1/MCR DTR/RTS kernel bug, default = 0

==== cool_timeout_init ====
{{Optional/en}}
NEW svn6286:01/23/2012

cool_timeout_init = timeout in milli seconds, default = 0

set card init mode for '''AZBox''' internal reader

==== cool_timeout_after_init ====
{{Optional/en}}
NEW svn6253:01/17/2012

[[Datei:WarningS.png|text-bottom]] '''Attention: only for Coolstream!'''

cool_timeout_after_init = timeout in milli seconds, default = 0

set read/transmit timeout after SC init in milli-seconds for Coolstream internal reader only, default:150

==== ins2e06 ====
{{Optional}}
NEW svn9568:03/16/2014
add check control for pin payload (4 hex bytes) for NDS Videoguard 2 SCs
ins2e06 = Payload
= # none [blank] (default)
[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only
http://www.streamboard.tv/oscam/changeset/9568

==== ins7e ====
{{Optional/en}}
NEW svn5959:09/22/2011

ins7e = payload
= [none] default
Add 26 hex-bytes payload for '''NDS Videoguard 2 SCs'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only

==== ins7e11 ====
{{Optional/en}}
NEW svn6064:12/06/2011

ins7e11 = TA1 Byte
= # [none] default
= 11 # 0001 FI + 0001 DI (1 x)
= 13 # 0001 FI + 0011 DI (4 x)
= 14 # 0001 FI + 0100 DI (8 x)
= 15 # 0001 FI + 0101 DI (16 x)

Add TA1 Byte for '''NDS Videoguard 2 SCs'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only
 
==== fix07 ====
NEW svn9884:09/30/2014
{{Optional/en}}
enable 0x07 fix for NDS Viedeoguard 2 SCs
fix07 = 1 # enabled (default)
= 0 # disabled
[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only

==== force_irdeto ====
{{Optional/en}}

force Irdeto SC mode even if RSA key is set for Irdeto tunneled Nagravion SC
force_irdeto = 1 # yes
= 0 # no (default)

==== nagra_read ====
{{Optional/en}}

read '''Nagravison''' records (on NCMED cards only):
nagra_read = 0 # disabled (default)
= 1 # read all records with expired rights
= 2 # read records with valid rights only

==== rsakey ====
{{Optional/en}}
CHANGE svn7046:06/12/12

RSA key for Nagravision/Tiger SCs / CAM key data for Irdeto SCs, Conax SCs, default = none

==== fix9993 ====
{{Optional/en}}

fix9993 = 0|1

enabled fix for 9993 error with CAID 0919 SCs.

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

==== readtiers ====
{{Optional/en}}
NEW svn10376:02/02/15

readtiers = 0|1|2

method to get tiers of NDS Videoguard SCs

readtiers = 0 # disabled (default)
readtiers = 1 # ins70 (new) method
readtiers = 2 # ins76 (old) method

==== boxkey ====
{{Optional/en}}
box key for Nagravision SCs / CAM key for Irdeto SCs / sessionkey for Seca SCs / CamID for Viaccess

==== pincode ====
{{Optional/en}}

pincode for '''Conax, Cryptoworks an Viaccess''' SCs
pincode = pincode
= # [blank] default

==== boxid ====
{{Optional/en}}

NDS receiver box id
boxid = NDS box ID

==== ndsversion ====
{{Optional/en}}

set NDS '''Videoguard''' version
0 = # autodetection (default)
1 = # NDS Videoguard 1
12 = # NDS Videoguard 1+
2 = # NDS Videoguard 2

==== aeskeys ====
{{Optional/en}}

multiple 16 bytes AES keys for Viaccess SCs (the used postprocessing AES key is specified through the D2 nano of the ECM)

CAID #ident:AES key #0 CAID #0[,AES key #1 CAID #0],...[;CAID #1@ident::AES key #0 CAID #1[,AES key #1 CAID #1],...]...

special AES keys:
00 = do not return any CW, no AES key specified
FF = return CW received from the S, no AES key specified

Example:
aeskeys = 0500@012345:000102030405060708090a0b0c0d0e0f;0500@543210:0,0,0f0e0d0c0b0a090807060504030201
aeskeys = 0500@012345;key0,key1,key2,key3,key4,key5,...;0500@543210:key0,key1,key2,key3,key4,key5,...
if keys are unknown replace them with 0 exemple: 0500@012345;key0,key1,0,0,key4,key5,...

==== showcls ====
OBSOLETE svn6624:04/23/2012
{{Optional/en}}

number of classes subscriptions to show for '''Viacces-SCs'''
schowcls = quantity
= 0 # (default)

==== key ====
{{Depends/en}}
key for newcamd remote reader encryption
key = DES key

==== user ====
{{Optional/en}}
user for remote reader (name)

==== password ====
{{Optional/en}}
password for remote reader

==== mg-encrypted ====
{{Optional/en}}

VERALTET - OBSOLETE - OBSOLÈTE - ANTIQUATO

mgcamd encrypted '''gbox line'''

format:

{ <IP|hostname> { <local port> <remote port> { <password> { <level> <level> } address> }

default:
MAC address=eth0

==== services ====
{{Optional}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If loadbalancing is enabled in oscam.conf [global] among lb_mode, then there may be '''no entries'''!

[[Datei:WarningS.png|text-bottom]] '''Attention:''' The number of services that will be considered based reader, is limited to 64, or 64 times [[service-name][CAID][provid][srvid]]!

What services can the reader. This requires a oscam.services be present. The logic here is as follows (in this order):
* If the field is empty (or invalid), the request is allowed.
* When a negative service (ie, those with "!") is applicable, the request is rejected.
* If a positive service is applicable or there is no positive service, the request is allowed.
* If none of the previous points, the request is rejected.
This means that negative Services are only necessary in individual cases. Namely, if and when services has positive, but it wants to exclude some back. This is not recommended, because here comes quickly to misconfigurations. Instead, an additional service to be created that contains all the relevant channels.

[de]assignment to service group
services = [!]services[,[!]<services>]...
= [blank] is default

==== caid ====
{{Optional/en}}

caid = <CAID>[&<mask>][:<target CAID>][,<CAID>[&<mask>][:target <CAID>]]...

define and mapping of CAIDs for reader, default:all CAIDs with mask FFFF

example:
caid = 0100
caid = 0200&ffee:0300
caid = 0400&ff00:0500,0600
caid = 0702,0722
caid = 0702&ffdf (shortcut for the example above)

==== ident ====
{{Optional/en}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If in oscam.conf [global] loadbalancing is enabled among lb_mode, then there may be '''no entries'''! 
This parameter is only used for EMM and then it is not used for ECM. So you cannot force ECM to be sent to the card using this parameter. 

define CAID and ident '''SC specific''' for reader:
ident 0 <CAID>:<ident>[,ident]...[;<CAID>:<ident>[,ident]...]...

Example
ident = # 0100:123456,234567;0200:345678,456789
= # [blank] no definition (default)

==== class ====
{{Optional/en}}

define class '''in hex''' SC specific for reader:
class = 01,02,!1b,!2b # 01 and 01 yes, 1b and 2b no
= # [blank] no definition (default)

==== localcards ====
{{Optional/en}}

Use this reader (for defined CAIDs only) as "local" in LB/reader selection.
It will be handle as a local reader per LB and preferlocalcards settings. In this way, we can consider a network reader as local, like we had a cardreader.

localcards = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]....

==== chid ====
{{Optional/en}}

define '''Irdeto ChID''' for reader

Example:
chid = 0100:12
chid = 0100:12;0604:0000BA,000101,00010E,000141
= # [blank] default

==== group ====
{{required}}
CHANGE svn6103:12/21/2011

Reader assingment to group. Each reader must be listed in one or more groups. This will determine, which client has access on what reader. Valid values 1-64
group = 1....64[,1....64]....

'''set required = [blank] default not allowed!'''

Example:
Group = 1 # (one group)
Group = 1,4,5 # (more groups)

==== audisabled ====
{{Optional/en}}

exclude reader from auto AU (auto update)
audisabled = 1 # excludet
= 0 # not excludet (default)

==== auprovid ====
{{Optional/en}}
set provider ID to use the right reader for auto AU

Example
auprovid = # 123456
= # [blank] default

==== disableserverfilter ====
{{Optional/en}}
ignore caid and ident settings of reader due faulty clients
disableserverfilter = 1 # ignore
= 0 # not ignore (default)

==== inactivitytimeout ====
{{Depends/en}}
inactivity timeout in seconds

inactivitytimeout = seconds
= -1 # reconnect on network failure for '''newcamd''' based readers, even in idle
= 0 # default

==== reconnecttimeout ====
{{Optional/en}}

CHANGE svn7244:08/07/2012

Reconnect from a remote reader, if missing answers in seconds

Example
reconnecttimeout = 20 # after 20 seconds new connection
= # [blank] default

==== connectoninit ====
{{Optional/en}}
NEW svn8235:01/29/2013

connectoninit = 0|1

1 = allow newcamd connections to be established on starup although there isn't a request yet
0 = default

==== keepalive ====
{{Optional/en}}
NEW svn9810:07/22/2014

keepalive = 0|1

1 = allow cs378x TCP socket to be always connected
0 = always on if cacheex reader type

==== fallback ====
{{Optional/en}}

Define reader as fallback, standard and fallback reader must have the same group, see '''group'''!
fallback = 1 # fallbackreader
= 0 # no fallbackreader (default)

==== fallback_percaid ====
{{Optional/en}}
NEW svn8896:09/04/2013

fallback_percaid = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]...

use reader as fallback for defined CAIDs only, two digit wildcards CAIDs are possible, fallback_percaid overrules fallback. Def.=none

example:
fallback_percaid = 1234:234567;10:345678

==== emmcache ====
{{Optional/en}}

set EMM cache of local reader

[[Datei:WarningS.png|text-bottom]] '''Attention:'''

Without this parameter, no EMM are shown in the log!

Format:
'''''emmcache = <usecache>,<rewrite>,<logging>,<stb-emm>'''''

* <usecache> 0 = # disable usage of emmcache and emmstats (default)
* <usecache> 1 = # enable emmcache, emmstats and save to file if oscam is stopped
* <usecache> 2 = # enable emmcache, emmstats but dont save to file if oscam is stopped

* <rewrite> n = # determines how often one and the same EMM is written. '''only if <usecache> = 1 or 2'''

* <logging> 0 = # EMM logging disabled
* <logging> 1 = # logging EMM errors
* <logging> 2 = # logging written EMMs
* <logging> 4 = # logging skipped EMMs
* <logging> 8 = # logging blocked EMMs
* <logging> 16 = # logging audisabled EMMs

* <stb-emm> 0 = # EMM for STB are ignored (default)
* <stb-emm> 1 = # EMM for STB are sent to the reader (very specific usage)

Sumarizing this values is possible. 31 shows all kinds of messages.

Example:
emmcache = 1,3,10,0 # Cache on, write 3 x, log written (2) and blocked (8) = 10 , don't send stb-emm
emmcache = 1,2,6,1 # Cache on, write 2 x, log written (2) and skipped (4) = 6, send stb-emm

'''stb-emm''': is only handy for specific usage (Viaccess: see commit [http://www.streamboard.tv/oscam/changeset/10584 #10584] ) In Viaccess we saw some EMM-G that are for the STB and not for the card. That's why we call it EMM-STB (Set Top Box). Those EMMs are, for exemple, used to define overencryption key (AES) into the STB to encrypt STB-Card dialog.
 

==== emmreassembly ====
{{Optional/en}}
NEW svn8493:03/06/2013

OBSOLETE svn8591:04/01/2013 parameter now in oscam.user!

emmreassembly = 0|1

1 = enable EMM reassembly, default
0 = disable EMM reassembly

should be set for Viaccess and Cryptoworks readers if the client that you are using to send EMMs is reassembling than instead of just sending them to OSCam for processing

 

==== cacheex ====
{{Optional/en}}
NEW svn6044:11/27/2011

cacheex = 0|1|2|3

1 = enable cache exchange pull mode
2 = enable cache exchange push mode
3 = enable cache exchange reversepush mode
0 = default
for camd 3.5x and CCcam protocol

see also on oscam.user!

Identical cache exchange modes must be set on local OSCam server and remote OSCam user account!

===== cacheex-modes =====
===== cacheex = 1 - cachepull =====
Situation:

OSCam A reader1 has cacheex = 1

OSCam B account1 has cacheex = 1

OSCam A gets a ECM request, reader1 send this request to OSCam B,

OSCam B checks his cache:
* Not found in cache: return NOK
* Found in cache: return OK+CW
* Not found in cache, but found pending request: wait ''cacheexwaittime'' in oscam.conf [global] and check again. OSCam B never requests new EMMs.

CW-flow = B ---> A

===== cacheex = 2 - cachepush =====
Situation:

OSCam A reader1 has cacheex = 2

OSCam B account1 hastcacheex = 2

If OSCam B gets a CW, its pushed to OSCam A, reader has normal functionality and can request ECMs.
* Problem: OSCAM can only push CW's if OSCam A is connected
* Problem or feature?: OSCam A reader can request ECMs from OSCam B

CW-flow = B ---> A

===== cacheex = 3 - reversecachepush =====
Situation:

OSCam A reader 1 has cacheex = 3

If OSCam A gets a CW, its pushed to OSCam B. OSCam A never requests new ECMs.

CW-flow = A ---> B

==== cacheex_maxhop ====
{{Optional/en}}
NEW svn6691:05/07/2012

cacheex_maxhop = hops
= default = 10 hops

define maximum hops for cach exchange

==== logport ====
{{Optional/en}}

Camd 3.x reader logport, camd 3.x UDP must be activated, only works if there's no camd 3.x cascading
logport = # port number
= 0 # disabled (default)

==== ecmwhitelist ====
{{Optional/en}}

ecmwhitelist = [CAID[@provid]:]length[,length]...[;[CAID[@provid]:]length[,length]...]...

define valid ECM length in '''hex''' and provid for physical reader

example
ecmwhitelist = 10,20,30,0a,0b,0c
= 0100:10,20;0200@12345:0a,4b
[blank] = none (default) and provid 000000

[[Datei:WarningS.png|text-bottom]] '''In normal operation mode this parameter ist not required!'''

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/ECMLengthList|List of ECM lengths]]'''

==== ecmheaderwhitelist ====
{{Optional/en}}
NEW svn7480:09212012

ecmheaderwhitelist = [CAID[@provid]:]header[,header...[;[@provid]:]header[,header]...]...

set valid ECM header per CAID and provid '''in hex'''

default: none, provid = 000000

thread [[Streamboard-Thread:34748|here]]

[[Streamboard:oscam/wiki/HeaderWhitelist|HeaderWhitelist]] here

==== ratelimitecm ====
{{Optional/en}}

number of different SIDs in ECMs allowed for an interval
ratelimitecm = # number
= 0 # (default)

==== ecmnotfoundlimit ====
{{Optional/en}}
NEW svn8313:02/07/2013

ecmnotfoundlimit = count

number of ECMs with "not found" answer until the reader will be restarted, 0 = no limit (default)

==== resetcycle ====
{{Optional/en}}
NEW svn5820:08/12/2011

resetcycle = count

number of ECMs until SC reset ist performerd

[[Datei:WarningS.png|text-bottom]] '''Hint:''' Valid for physical readers only!

example:
resetcycle = 0 # disabled [default]
= 5 # reset after 5 ECM's

==== ratelimittime ====
{{Optional/en}}
NEW svn9078:09/12/2013

interval for rate limit in milliseconds
ratelimittime = # milliseconds
= 0 # (default)
 

==== ecmunique ====
{{Optional/en}}
NEW svn8491:03/06/2013

ecmunique = 0|1

1 = enable check for matching ECM hash in ratelimit slot
0 = default

 

==== srvidholdtime ====
{{Optional/en}}
NEW svn9078:09/12/2013

srvidholdtime = milliseconds

time to keep service ID in ratelimit slot, during this time checking for ecmunique ist disabled.
0 = default
 

==== cooldown ====
{{Optional/en}}

cooldown = delay, duration

define cooldown:
delay = delay in milliseconds for which the reader is allowed to do more
ECM requests then defined by parameter "ratelimitecm"
default: [blank] none
duration = duration in milliseconds the reader needs to cooldown
default: [blank] none

Both parameters are mandatory when used.

'''parameter "ratelimitecm" and "ratelimittime" are required!'''

==== blocknano ====
{{Optional/en}}
list of EMM-nanos to block (in hex w/o 0x) or all EMM-nanos, only valid for physical readers!

Example:
blocknano = 45,93,7a,ff
= all
= # [blank] (default)

==== blockemm-u ====
{{Optional/en}}

block unique EMMs
blockemm-u = 0 # (no block) default
blockemm-u = 1 # (block EMMs, which are addressed to card immediatly) )

==== blockemm-s ====
{{Optional/en}}

block shared EMMs
blockemm-s = 0 # (no block) default
blockemm-s = 1 # (block EMMs, which are addressed to certain groups of cards)

==== blockemm-g ====
{{Optional/en}}

block global EMMs
blockemm-g = 0 # (no block) default
blockemm-g = 1 # (block EMMs, which are addressed to all cards)

==== blockemm-unknown ====
{{Optional/en}}

block unknown types of EMMs
blockemm-unknown = 0 # (no block) default
blockemm-unknown = 1 # (block all unknown kinds of EMMs)

==== blockemm-bylen ====
{{Optional/en}}

CHANGE svn8615:04/12/2013

blockemm-bylen = [length range,length range]... (decimal)

block all types of EMMs by length, maximum 10 values, default: none

example:
blockemm-bylen = 1-10,11-

 

==== via_emm_global ====
{{Optional/en}}

NEW svn9843:09/05/2014

via_emm_global == 0|1

enables global emm filter for '''viacces'''

'''only for camd35 (cs357x) protocol!'''

0 = default

 

====saveemm-u ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-u = 0 (default)
= 1

save unique EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

====saveemm-s ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-s = 0 (default)
= 1

save shared EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

====saveemm-g ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-g = 0 (default)
= 1

save global EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

====saveemm-unknown ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-unknown = 0 (default)
= 1

save unkown EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

==== savenano ====
{{Optional/en}}

OBSOLETE svn5947:09/09/2011

list of EMM-nanos (in hex w/o 0x) to save or all EMM-nanos. Only valid for physical readers. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

Format
nano[,nano]....|all

Beispiel
savenano = 45,93,7a,ff
= all
= # [blank] default

==== readnano ====
{{Optional/en}}
Write file (usually a copy of a file saved by savenano) to your smartcard, if no path is specified, the specified file is searched for in the configuration directory, only valid for physical readers!

Example:
readnano = write.emm
= /var/oscam/write.emm
= # [blank] (default)

==== use-ssl ====
{{Optional/en}}

NEW svn8725:06/25/20113

use_ssl = 0|1

use_ssl = 1 # use SSL for ghttp protocol
= 0 # default

==== dropbadcws ====
{{Optional/en}}

CHANGE svn5992:10/22/2011

dropbadcws = 0|1

dropbadcws = 1 # reject bad CWs, send "not found" instaed of bad CWs
= 0 # default

==== disablecrccws ====
{{Optional/en}}

NEW svn6004:10/26/2011

disablecrccrws = 1 # disable cw checksum test
= 0 # enable (default)

==== lb_weight ====
{{Optional/en}}

The higher the value the higher the probability for reader selection. It's an divider for the average responstime.
lb_weight = weight
= # [blank] Default-Wert 100

See here
[[Datei:Lb_weight_calc2.png]]

==== lb_whitelist_services ====
NEW svn8656:05/22/2013
{{Optional/en}}

lb_whitelist_services = <services>,<services>....

reader assignement to service group for channels which may never be blocked by the loadbalancer to the reader , default=none 
 
 
==== lb_force_fallback ====
{{Optional/en}}

NEW - svn9739:05/19/2014

lb_force_fallback = 0|1

1 = set the reader always as fallback for load blancing without considering the readers statistics 

0 = default
 
 

==== ccc ====

===== cccversion =====
{{Depends/en}}

'''Only for CCcam'''

define CCcam version
<nowiki><mainversion>,<version>,</nowiki>

Example
cccversion = 1.2.34

===== cccmaxhops =====
{{Depends/en}}

define CCcam maximum SC distance hops
0 = local SCs only
1 = local SCs and + 1 hop
2 = local SCs and + 2 hops
and so on
default = 10

===== ccchop =====
{{Depends/en}}

ccchop = hop

Set hop for '''non''' CCCam readers

default = 0

===== cccreshare =====
{{Depends/en}}

CHANGE svn8607:04/10/2013

Define reader's CCcam reshare hop

cccreshare = -1 # no resharing
= 0 # reshare for direct peer only
= 1 # reshare for direct peer and next level
= x # resharing for direct peer and share level x

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 !

===== cccwantemu =====
{{Depends/en}}

Request to provide emu from CCCam server, too.
cccwantemu = 1 # yes
= 0 # no (default)

===== ccckeepalive =====
{{Depends/en}}

Send keepalive messages to keep connection to remote CCCam server up
ccckeepalive = 1 # yes
= 0 # no (default)

===== cccreconnect =====
{{Optional/en}}

cccreconnect = timeout (milli-seconds)

reconnect again after ECM request timeout in milli-secons, default = 12000 milliseconds

===== cccmindown =====
{{Depends/en}}

Filters all readers with hops smaller than number
cccmindown = # number
= 0 # default

 
 

==== '''gbox''' ====
NEW svn8350:02/15/2013
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
[reader]
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 
===== device =====
{{required}}

device = Comma-separated list of values:

peer's IP or hostname
peer's port

example:
192.168.1.101,3820

 

===== password =====
{{required}}

password = 4 hex bytes, 8 chars

peer password

example:
A123BCDE

 

===== my_password =====
{{required}}

OBSOLETE svn9163:12/31/2013 '''moved to oscam.conf [gbox]'''

Passwort = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

===== gbox_reshare =====
{{Optional/en}}

Reshare-Level of local card(s), default = 0

 

===== gbox_max_distance =====
{{Optional/en}}

gbox_max_distance = max distance to receive peer cards, default = 2

 

===== gbox_max_ecm_send =====
{{Optional/en}}

gbox_max_ecm_send = send ecm to max <gbox_max_ecm_sen> peer cards, default = 3

 

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

user name of oscam gbox

example
user = gbox_client

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
'''user must also be inserted in oscam.user [account]

'''Set suitable filters (services=, caid=, ident=) in [reader] and [account] section
'''to prevent gbox instability by overflooding with too many cards

==== '''DRE''' ====
===== exec_cmd_file =====
{{Optional/en}}

exec_cmd_file = path_to_a_script

===== stmkeys =====
{{Optional/en}}

stmkeys = path_to_a_key_file

===== force_ua =====
{{Optional/en}}

force_ua = 4 Bytes or 8 chars (expressed in hexa)

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.server

2016-12-21T08:23:24Z

Pr2: /* cooldown */

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

== oscam.server ==
The server configuration file for OSCam contains reader parameters. Sections in oscam.server are recurring (more than one reader possible). At least one [reader] section is required. Examples for reader configuation you will find here [[OSCam/en/examples/Reader|example configurations]]

{{OSCamServerParameter}}

=== [reader] ===
Define local or remote reader

==== label ====
{{required}}

name for reader

Example:
label = easymouse2

==== enable ====
{{Optional/en}}
deactivate reader
0 = off
1 = On (default)

==== description ====
{{Optional/en}}

description = text

description of reader, default: [blank] none

==== protocol ====
{{required}}

reader protocol
protocol = mouse (local cardreader)
= internal (all cardreader with "device=/dev/sciX", and internal Coolstream-Reader)
= camd35|cs357x (cascading - camd 3.5-compatible remote server - udp)
= mp35
= smartreader
= serial
= cs378x (camd 3.5-compatible remote server - tcp)
= gbox
= newcamd|newcamd525
= newcamd524
= cccam
= radegast
= pcsc
= constcw
= sc8in1
= smargo

==== device ====
{{required}}

CHANGE svn8057+8059:01/04/2013

CHANGE svn8096:01/13/2013

CHANGE svn8911:09/10/2013

define local or remote reader

device = [<readertype>;]serial:serialnum|bus:device|<device|device:slot>|<ip|hostname>,<port>[,<lport>]|pcsc|<0|1>>|constantcw

set reader type

readertype:
SR: Smartreader+ (default)
SRv2: Smartreader V2
Infinity: Infinity USB
TripleP1: Smargo Triple Reader port 1
TripleP2: Smargo Triple Reader port 2
TripleP3: Smargo Triple Reader port 3

bus:device: bus name and device name of the smartreader+
(get the name with lsusb 'Bus' ans 'Device')

serialnum: Serial-Nummer des Smartreader+ or Ininity USB (get the serial number while starting OSCam)

device: device name

device:slot: device name and slot number sc8in1 /1-8)
(only one sc8in1 reader supported)

ip|hostname: IP address or host name

port: TCP/IP port

lport: remapping to local TCP/IP port

PCSC: number of PCSC reader, starting with 0

0|1: ''' for Coolstream HD-1 STB only''': select reader 0 or reader 1

constantcw: constant CW file name

CW-File-Format:
'''Standard'''
CAID:Provider ID:Service ID:PMT ID:ECM PID::key (16 Bytes seperated by spaces)
example:
1234:123456:1234:2345:3456::00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

'''Extended OSCam-Format'''
CAID:Provider ID:Service ID:PMT ID:ECM PID:Video PID:key (16 Bytes seperated by spaces)
example:
1234:123456:1234:2345:3456:7890:00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

Examples for device parameters
device = /dev/ttyS0 # (Reader on COM1 (Linux i386 and Windows))
device = /dev/tts/1 # (Reader on COM2 (Linux dbox2 with multicam))
device = /dev/ttyUSB0 # (Reader on USB (Linux i386))
device = /dev/ttyUSB0:1 # Slot 1 SC8in1 or MCR 4/8 (Linux i386)

'''Attention:''' Counting begins with 0, that means number of device is one less than number of COM-Port! Eg ttyS0 = COM1, tts/1 = COM2.

==== detect ====
{{Depends/en}}

status detect of card '''is in'''
analysis by fun7:

Detect = CD - Carrier Detect, is a line that is used by the switch (open / closes a circuit)
for '''protocol = mouse'''
'''default'''

Detect = DSR - Data Set Ready: is a V24 / (RS232) interface signal that is transmitted on PIN 6 of a D-SUB connector.
I guess the detection itself has to be processed by the cardreaders ICs itself and is later on beeing
transmitted on pin6.

Detect = CTS - Clear To Send) - RTS - Ready to send : A RTS (ready to send) request is beeing send out from the reader.
Usually the oscam will answer with a '''CTS''' (clear to send) response, telling its ready to receive.
That feature had a common use on analog modems in the past.

Detect = RING - Ring Indicator: this describes a so called RING indicator - like the ring of a telephone - that is specified
in the RS232 specs to signalize an incoming call. In the context of oscam this should mean: reader is ringing
the oscam after card insertion, telling the oscam its desire to create a data connection. Like the word "ring"
indicates, this was used in serial connections of modems as well.

Detect = NONE - detect switched off, but signal "card is in"

Detect = GPIO - GPIO means "general purpose input output". Used for '''mipsel-uclib''', I could imagine this could be useful if
you want to play around with a '''raspberry pi''' and transmit the cardstatus to its gpio pin.
[gpio1,...gpio7]

* Inverse = prefix "!"(eg "detect=!CTS")

example
[reader]
label = mymouse
description = mymouse xxx
'''protocol = mouse'''
device = /dev/ttyUSB0 (easymouse 2)
services = xxx
boxkey = 1122334455667788
force_irdeto = 1
'''detect = cd'''
mhz = 1000
cardmhz = 600
group = 1,2,3
emmcache = 1,3,2

==== cardmhz ====
{{Depends/en}}
CHANGE svn7046:06/12/12

set standard SC frequency in units of 10 kHz, for Irdeto SC set to 600, refer to [[OSCam/en/examples/Overclocking|Overclocking]]
Example:
cardmhz = 600 # Irdeto card
= # [blank] 357 (default)

'''INTERNAL READERS'''

If you use cardmhz >2000 OScam will switch to PLL clocking. Internal readers of boxes from Dream Multimedia GmbH can be clocked more precise with it.

The used cardmhz should reflect the highest frequency of the PLL crystal in the internal cardreader. OSCam will calculate the best PLL divider that comes nearest to the wanted user card speed specified in cardmhz.

Use the following settings:

Models with PPC-CPU (DM500/DM600/DM7000/DM7020) use "cardmhz = 3150"

Models with MIPS-CPU (DM500HD/DM800/DM800SE/DM8k/DM7020HD etc.) use "cardmhz = 2700"

DM7025 is special, use "cardmhz = 8300"

'''If only the parameter cardmhz is set (without mhz = xxx) then Oscam clocks the card automatically with the ATR! '''

E.G. You have a dream 800 HD PVR, thats a mips so you should set cardmhz to 2700. We got a nagra card that should run on 5 MHz. If

you want to clock the card ok just use cardmhz = 2700 an mhz = 500. If you want to overclock it use cardmhz = 2700 and mhz = 900.

Now your card will start to run 9 Mhz. Better monitor it! An overclocked card could run hot or crash suddenly!

Keep in mind that most internal readers of non-dreamboxes clock the cards automatically and copletely ignore any user clockspeed setting. But you should set cardmhz and mhz anyway, as its still used to calculate the correct timings in OSCam. If you set cardmhz/mhz correct the timings will better match with the actual (automatically) clockspeed of the internal card reader. As for a result slighly better ecm responses or more stable functioning.

Dont expect magic here, only overclocking the cardspeed can reduce the ecm response time. Bad timings can only delay it or make the card responses instable!
[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== mhz ====
{{Optional/en}}
CHANGE svn 9064:12/13/2013

set reader frequency in units of 10 kHz, if mhz > cardmhz you are in overclocking mode, refer to [[OSCam/en/examples/Overclocking|Overclocking]]

Example:
# Default 357
cardmhz = 600 # ( 6000 KHz = 6 MHz)
mhz = 1000 # (10000 KHz = 10 MHz)

auto clock speed in '''Dreambox mode''' set to -1. Further Informations about the various (Dream)Boxes can be found [http://www.streamboard.tv/oscam/wiki/ReaderClocks here].

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== autospeed ====
{{Optional/en}}
NEW svn9064:12/01/2013

autospeed = 0|1

autospeed = 0 disabled
autospeed = 1 (default) Sets mhz according to ATR. Currently only used for smartreader, smargo protocol and Dreambox-readers internal protocol. Other readers will be adapted to use this
parameter as well. In webif checked means 1. If you want to overclock your card set autospeed to 0.

==== deprecated ====
{{Optional/en}}
First the SC will be initialized in normal mode. If it fails, the SC will be automatically reverted to deprecated mode, so that the SC speed will not be changed and the communication will remain on normal ATR speed of 9600 baud.

deprecated = 1 use deprecated SC mode only
= 0 default

==== mode ====
{{Depends/en}}
set card init mode for '''AzBox''' reader
mode = 1 # AzBox-Reader
= 0 # none (default)

==== device_out_endpoint ====
{{Depends/en}}

CHANGE svn8013:12/29/2012

set endpoint address for FTDI chips
device_out_endpoint = 0x81 # Smargo Triple Reader port 1
= 0x82 # Smartreader+ (default)
= 0x83 # Smargo Triple Reader port 2
= 0x85 # Smargo Triple Reader port 3

==== smargopatch ====
{{Optional/en}}
NEW svn6402:02/16/2012

smargopatch = 0|1

enable workaround for smartreader+ and reader until native mode works, default = 0

==== sc8in1_dtrrts_patch ====
{{Optional/en}}
NEW svn6402:02/16/2012

sc8in1_dtrrts_patch = 0|1

enable fix for SC8in1/MCR DTR/RTS kernel bug, default = 0

==== cool_timeout_init ====
{{Optional/en}}
NEW svn6286:01/23/2012

cool_timeout_init = timeout in milli seconds, default = 0

set card init mode for '''AZBox''' internal reader

==== cool_timeout_after_init ====
{{Optional/en}}
NEW svn6253:01/17/2012

[[Datei:WarningS.png|text-bottom]] '''Attention: only for Coolstream!'''

cool_timeout_after_init = timeout in milli seconds, default = 0

set read/transmit timeout after SC init in milli-seconds for Coolstream internal reader only, default:150

==== ins2e06 ====
{{Optional}}
NEW svn9568:03/16/2014
add check control for pin payload (4 hex bytes) for NDS Videoguard 2 SCs
ins2e06 = Payload
= # none [blank] (default)
[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only
http://www.streamboard.tv/oscam/changeset/9568

==== ins7e ====
{{Optional/en}}
NEW svn5959:09/22/2011

ins7e = payload
= [none] default
Add 26 hex-bytes payload for '''NDS Videoguard 2 SCs'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only

==== ins7e11 ====
{{Optional/en}}
NEW svn6064:12/06/2011

ins7e11 = TA1 Byte
= # [none] default
= 11 # 0001 FI + 0001 DI (1 x)
= 13 # 0001 FI + 0011 DI (4 x)
= 14 # 0001 FI + 0100 DI (8 x)
= 15 # 0001 FI + 0101 DI (16 x)

Add TA1 Byte for '''NDS Videoguard 2 SCs'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only
 
==== fix07 ====
NEW svn9884:09/30/2014
{{Optional/en}}
enable 0x07 fix for NDS Viedeoguard 2 SCs
fix07 = 1 # enabled (default)
= 0 # disabled
[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only

==== force_irdeto ====
{{Optional/en}}

force Irdeto SC mode even if RSA key is set for Irdeto tunneled Nagravion SC
force_irdeto = 1 # yes
= 0 # no (default)

==== nagra_read ====
{{Optional/en}}

read '''Nagravison''' records (on NCMED cards only):
nagra_read = 0 # disabled (default)
= 1 # read all records with expired rights
= 2 # read records with valid rights only

==== rsakey ====
{{Optional/en}}
CHANGE svn7046:06/12/12

RSA key for Nagravision/Tiger SCs / CAM key data for Irdeto SCs, Conax SCs, default = none

==== fix9993 ====
{{Optional/en}}

fix9993 = 0|1

enabled fix for 9993 error with CAID 0919 SCs.

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

==== readtiers ====
{{Optional/en}}
NEW svn10376:02/02/15

readtiers = 0|1|2

method to get tiers of NDS Videoguard SCs

readtiers = 0 # disabled (default)
readtiers = 1 # ins70 (new) method
readtiers = 2 # ins76 (old) method

==== boxkey ====
{{Optional/en}}
box key for Nagravision SCs / CAM key for Irdeto SCs / sessionkey for Seca SCs / CamID for Viaccess

==== pincode ====
{{Optional/en}}

pincode for '''Conax, Cryptoworks an Viaccess''' SCs
pincode = pincode
= # [blank] default

==== boxid ====
{{Optional/en}}

NDS receiver box id
boxid = NDS box ID

==== ndsversion ====
{{Optional/en}}

set NDS '''Videoguard''' version
0 = # autodetection (default)
1 = # NDS Videoguard 1
12 = # NDS Videoguard 1+
2 = # NDS Videoguard 2

==== aeskeys ====
{{Optional/en}}

multiple 16 bytes AES keys for Viaccess SCs (the used postprocessing AES key is specified through the D2 nano of the ECM)

CAID #ident:AES key #0 CAID #0[,AES key #1 CAID #0],...[;CAID #1@ident::AES key #0 CAID #1[,AES key #1 CAID #1],...]...

special AES keys:
00 = do not return any CW, no AES key specified
FF = return CW received from the S, no AES key specified

Example:
aeskeys = 0500@012345:000102030405060708090a0b0c0d0e0f;0500@543210:0,0,0f0e0d0c0b0a090807060504030201
aeskeys = 0500@012345;key0,key1,key2,key3,key4,key5,...;0500@543210:key0,key1,key2,key3,key4,key5,...
if keys are unknown replace them with 0 exemple: 0500@012345;key0,key1,0,0,key4,key5,...

==== showcls ====
OBSOLETE svn6624:04/23/2012
{{Optional/en}}

number of classes subscriptions to show for '''Viacces-SCs'''
schowcls = quantity
= 0 # (default)

==== key ====
{{Depends/en}}
key for newcamd remote reader encryption
key = DES key

==== user ====
{{Optional/en}}
user for remote reader (name)

==== password ====
{{Optional/en}}
password for remote reader

==== mg-encrypted ====
{{Optional/en}}

VERALTET - OBSOLETE - OBSOLÈTE - ANTIQUATO

mgcamd encrypted '''gbox line'''

format:

{ <IP|hostname> { <local port> <remote port> { <password> { <level> <level> } address> }

default:
MAC address=eth0

==== services ====
{{Optional}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If loadbalancing is enabled in oscam.conf [global] among lb_mode, then there may be '''no entries'''!

[[Datei:WarningS.png|text-bottom]] '''Attention:''' The number of services that will be considered based reader, is limited to 64, or 64 times [[service-name][CAID][provid][srvid]]!

What services can the reader. This requires a oscam.services be present. The logic here is as follows (in this order):
* If the field is empty (or invalid), the request is allowed.
* When a negative service (ie, those with "!") is applicable, the request is rejected.
* If a positive service is applicable or there is no positive service, the request is allowed.
* If none of the previous points, the request is rejected.
This means that negative Services are only necessary in individual cases. Namely, if and when services has positive, but it wants to exclude some back. This is not recommended, because here comes quickly to misconfigurations. Instead, an additional service to be created that contains all the relevant channels.

[de]assignment to service group
services = [!]services[,[!]<services>]...
= [blank] is default

==== caid ====
{{Optional/en}}

caid = <CAID>[&<mask>][:<target CAID>][,<CAID>[&<mask>][:target <CAID>]]...

define and mapping of CAIDs for reader, default:all CAIDs with mask FFFF

example:
caid = 0100
caid = 0200&ffee:0300
caid = 0400&ff00:0500,0600
caid = 0702,0722
caid = 0702&ffdf (shortcut for the example above)

==== ident ====
{{Optional/en}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If in oscam.conf [global] loadbalancing is enabled among lb_mode, then there may be '''no entries'''! 
This parameter is only used for EMM and then it is not used for ECM. So you cannot force ECM to be sent to the card using this parameter. 

define CAID and ident '''SC specific''' for reader:
ident 0 <CAID>:<ident>[,ident]...[;<CAID>:<ident>[,ident]...]...

Example
ident = # 0100:123456,234567;0200:345678,456789
= # [blank] no definition (default)

==== class ====
{{Optional/en}}

define class '''in hex''' SC specific for reader:
class = 01,02,!1b,!2b # 01 and 01 yes, 1b and 2b no
= # [blank] no definition (default)

==== localcards ====
{{Optional/en}}

Use this reader (for defined CAIDs only) as "local" in LB/reader selection.
It will be handle as a local reader per LB and preferlocalcards settings. In this way, we can consider a network reader as local, like we had a cardreader.

localcards = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]....

==== chid ====
{{Optional/en}}

define '''Irdeto ChID''' for reader

Example:
chid = 0100:12
chid = 0100:12;0604:0000BA,000101,00010E,000141
= # [blank] default

==== group ====
{{required}}
CHANGE svn6103:12/21/2011

Reader assingment to group. Each reader must be listed in one or more groups. This will determine, which client has access on what reader. Valid values 1-64
group = 1....64[,1....64]....

'''set required = [blank] default not allowed!'''

Example:
Group = 1 # (one group)
Group = 1,4,5 # (more groups)

==== audisabled ====
{{Optional/en}}

exclude reader from auto AU (auto update)
audisabled = 1 # excludet
= 0 # not excludet (default)

==== auprovid ====
{{Optional/en}}
set provider ID to use the right reader for auto AU

Example
auprovid = # 123456
= # [blank] default

==== disableserverfilter ====
{{Optional/en}}
ignore caid and ident settings of reader due faulty clients
disableserverfilter = 1 # ignore
= 0 # not ignore (default)

==== inactivitytimeout ====
{{Depends/en}}
inactivity timeout in seconds

inactivitytimeout = seconds
= -1 # reconnect on network failure for '''newcamd''' based readers, even in idle
= 0 # default

==== reconnecttimeout ====
{{Optional/en}}

CHANGE svn7244:08/07/2012

Reconnect from a remote reader, if missing answers in seconds

Example
reconnecttimeout = 20 # after 20 seconds new connection
= # [blank] default

==== connectoninit ====
{{Optional/en}}
NEW svn8235:01/29/2013

connectoninit = 0|1

1 = allow newcamd connections to be established on starup although there isn't a request yet
0 = default

==== keepalive ====
{{Optional/en}}
NEW svn9810:07/22/2014

keepalive = 0|1

1 = allow cs378x TCP socket to be always connected
0 = always on if cacheex reader type

==== fallback ====
{{Optional/en}}

Define reader as fallback, standard and fallback reader must have the same group, see '''group'''!
fallback = 1 # fallbackreader
= 0 # no fallbackreader (default)

==== fallback_percaid ====
{{Optional/en}}
NEW svn8896:09/04/2013

fallback_percaid = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]...

use reader as fallback for defined CAIDs only, two digit wildcards CAIDs are possible, fallback_percaid overrules fallback. Def.=none

example:
fallback_percaid = 1234:234567;10:345678

==== emmcache ====
{{Optional/en}}

set EMM cache of local reader

[[Datei:WarningS.png|text-bottom]] '''Attention:'''

Without this parameter, no EMM are shown in the log!

Format:
'''''emmcache = <usecache>,<rewrite>,<logging>,<stb-emm>'''''

* <usecache> 0 = # disable usage of emmcache and emmstats (default)
* <usecache> 1 = # enable emmcache, emmstats and save to file if oscam is stopped
* <usecache> 2 = # enable emmcache, emmstats but dont save to file if oscam is stopped

* <rewrite> n = # determines how often one and the same EMM is written. '''only if <usecache> = 1 or 2'''

* <logging> 0 = # EMM logging disabled
* <logging> 1 = # logging EMM errors
* <logging> 2 = # logging written EMMs
* <logging> 4 = # logging skipped EMMs
* <logging> 8 = # logging blocked EMMs
* <logging> 16 = # logging audisabled EMMs

* <stb-emm> 0 = # EMM for STB are ignored (default)
* <stb-emm> 1 = # EMM for STB are sent to the reader (very specific usage)

Sumarizing this values is possible. 31 shows all kinds of messages.

Example:
emmcache = 1,3,10,0 # Cache on, write 3 x, log written (2) and blocked (8) = 10 , don't send stb-emm
emmcache = 1,2,6,1 # Cache on, write 2 x, log written (2) and skipped (4) = 6, send stb-emm

'''stb-emm''': is only handy for specific usage (Viaccess: see commit [http://www.streamboard.tv/oscam/changeset/10584 #10584] ) In Viaccess we saw some EMM-G that are for the STB and not for the card. That's why we call it EMM-STB (Set Top Box). Those EMMs are, for exemple, used to define overencryption key (AES) into the STB to encrypt STB-Card dialog.
 

==== emmreassembly ====
{{Optional/en}}
NEW svn8493:03/06/2013

OBSOLETE svn8591:04/01/2013 parameter now in oscam.user!

emmreassembly = 0|1

1 = enable EMM reassembly, default
0 = disable EMM reassembly

should be set for Viaccess and Cryptoworks readers if the client that you are using to send EMMs is reassembling than instead of just sending them to OSCam for processing

 

==== cacheex ====
{{Optional/en}}
NEW svn6044:11/27/2011

cacheex = 0|1|2|3

1 = enable cache exchange pull mode
2 = enable cache exchange push mode
3 = enable cache exchange reversepush mode
0 = default
for camd 3.5x and CCcam protocol

see also on oscam.user!

Identical cache exchange modes must be set on local OSCam server and remote OSCam user account!

===== cacheex-modes =====
===== cacheex = 1 - cachepull =====
Situation:

OSCam A reader1 has cacheex = 1

OSCam B account1 has cacheex = 1

OSCam A gets a ECM request, reader1 send this request to OSCam B,

OSCam B checks his cache:
* Not found in cache: return NOK
* Found in cache: return OK+CW
* Not found in cache, but found pending request: wait ''cacheexwaittime'' in oscam.conf [global] and check again. OSCam B never requests new EMMs.

CW-flow = B ---> A

===== cacheex = 2 - cachepush =====
Situation:

OSCam A reader1 has cacheex = 2

OSCam B account1 hastcacheex = 2

If OSCam B gets a CW, its pushed to OSCam A, reader has normal functionality and can request ECMs.
* Problem: OSCAM can only push CW's if OSCam A is connected
* Problem or feature?: OSCam A reader can request ECMs from OSCam B

CW-flow = B ---> A

===== cacheex = 3 - reversecachepush =====
Situation:

OSCam A reader 1 has cacheex = 3

If OSCam A gets a CW, its pushed to OSCam B. OSCam A never requests new ECMs.

CW-flow = A ---> B

==== cacheex_maxhop ====
{{Optional/en}}
NEW svn6691:05/07/2012

cacheex_maxhop = hops
= default = 10 hops

define maximum hops for cach exchange

==== logport ====
{{Optional/en}}

Camd 3.x reader logport, camd 3.x UDP must be activated, only works if there's no camd 3.x cascading
logport = # port number
= 0 # disabled (default)

==== ecmwhitelist ====
{{Optional/en}}

ecmwhitelist = [CAID[@provid]:]length[,length]...[;[CAID[@provid]:]length[,length]...]...

define valid ECM length in '''hex''' and provid for physical reader

example
ecmwhitelist = 10,20,30,0a,0b,0c
= 0100:10,20;0200@12345:0a,4b
[blank] = none (default) and provid 000000

[[Datei:WarningS.png|text-bottom]] '''In normal operation mode this parameter ist not required!'''

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/ECMLengthList|List of ECM lengths]]'''

==== ecmheaderwhitelist ====
{{Optional/en}}
NEW svn7480:09212012

ecmheaderwhitelist = [CAID[@provid]:]header[,header...[;[@provid]:]header[,header]...]...

set valid ECM header per CAID and provid '''in hex'''

default: none, provid = 000000

thread [[Streamboard-Thread:34748|here]]

[[Streamboard:oscam/wiki/HeaderWhitelist|HeaderWhitelist]] here

==== ratelimitecm ====
{{Optional/en}}

number of different SIDs in ECMs allowed for an interval
ratelimitecm = # number
= 0 # (default)

==== ecmnotfoundlimit ====
{{Optional/en}}
NEW svn8313:02/07/2013

ecmnotfoundlimit = count

number of ECMs with "not found" answer until the reader will be restarted, 0 = no limit (default)

==== resetcycle ====
{{Optional/en}}
NEW svn5820:08/12/2011

resetcycle = count

number of ECMs until SC reset ist performerd

[[Datei:WarningS.png|text-bottom]] '''Hint:''' Valid for physical readers only!

example:
resetcycle = 0 # disabled [default]
= 5 # reset after 5 ECM's

==== ratelimittime ====
{{Optional/en}}
NEW svn9078:09/12/2013

interval for rate limit in milliseconds
ratelimittime = # milliseconds
= 0 # (default)
 

==== ecmunique ====
{{Optional/en}}
NEW svn8491:03/06/2013

ecmunique = 0|1

1 = enable check for matching ECM hash in ratelimit slot
0 = default

 

==== srvidholdtime ====
{{Optional/en}}
NEW svn9078:09/12/2013

srvidholdtime = milliseconds

time to keep service ID in ratelimit slot, during this time checking for ecmunique ist disabled.
0 = default
 

==== cooldown ====
{{Optional/en}}

cooldown = delay, duration

define cooldown:
delay = delay in milliseconds for which the reader is allowed to do more
ECM requests then defined by parameter "ratelimitecm"
default: [blank] none
duration = duration in milliseconds the reader needs to cooldown
default: [blank] none

Both parameters are mandatory when used.

'''parameter "ratelimitecm" and "ratelimittime" are required!'''

==== blocknano ====
{{Optional/en}}
list of EMM-nanos to block (in hex w/o 0x) or all EMM-nanos, only valid for physical readers!

Example:
blocknano = 45,93,7a,ff
= all
= # [blank] (default)

==== blockemm-u ====
{{Optional/en}}

block unique EMMs
blockemm-u = 0 # (no block) default
blockemm-u = 1 # (block EMMs, which are addressed to card immediatly) )

==== blockemm-s ====
{{Optional/en}}

block shared EMMs
blockemm-s = 0 # (no block) default
blockemm-s = 1 # (block EMMs, which are addressed to certain groups of cards)

==== blockemm-g ====
{{Optional/en}}

block global EMMs
blockemm-g = 0 # (no block) default
blockemm-g = 1 # (block EMMs, which are addressed to all cards)

==== blockemm-unknown ====
{{Optional/en}}

block unknown types of EMMs
blockemm-unknown = 0 # (no block) default
blockemm-unknown = 1 # (block all unknown kinds of EMMs)

==== blockemm-bylen ====
{{Optional/en}}

CHANGE svn8615:04/12/2013

blockemm-bylen = [length range,length range]... (decimal)

block all types of EMMs by length, maximum 10 values, default: none

example:
blockemm-bylen = 1-10,11-

 

==== via_emm_global ====
{{Optional/en}}

NEW svn9843:09/05/2014

via_emm_global == 0|1

enables global emm filter for '''viacces'''

'''only for camd35 (cs357x) protocol!'''

0 = default

 

====saveemm-u ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-u = 0 (default)
= 1

save unique EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

====saveemm-s ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-s = 0 (default)
= 1

save shared EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

====saveemm-g ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-g = 0 (default)
= 1

save global EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

====saveemm-unknown ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-unknown = 0 (default)
= 1

save unkown EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

==== savenano ====
{{Optional/en}}

OBSOLETE svn5947:09/09/2011

list of EMM-nanos (in hex w/o 0x) to save or all EMM-nanos. Only valid for physical readers. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

Format
nano[,nano]....|all

Beispiel
savenano = 45,93,7a,ff
= all
= # [blank] default

==== readnano ====
{{Optional/en}}
Write file (usually a copy of a file saved by savenano) to your smartcard, if no path is specified, the specified file is searched for in the configuration directory, only valid for physical readers!

Example:
readnano = write.emm
= /var/oscam/write.emm
= # [blank] (default)

==== use-ssl ====
{{Optional/en}}

NEW svn8725:06/25/20113

use_ssl = 0|1

use_ssl = 1 # use SSL for ghttp protocol
= 0 # default

==== dropbadcws ====
{{Optional/en}}

CHANGE svn5992:10/22/2011

dropbadcws = 0|1

dropbadcws = 1 # reject bad CWs, send "not found" instaed of bad CWs
= 0 # default

==== disablecrccws ====
{{Optional/en}}

NEW svn6004:10/26/2011

disablecrccrws = 1 # disable cw checksum test
= 0 # enable (default)

==== lb_weight ====
{{Optional/en}}

The higher the value the higher the probability for reader selection. It's an divider for the average responstime.
lb_weight = weight
= # [blank] Default-Wert 100

See here
[[Datei:Lb_weight_calc2.png]]

==== lb_whitelist_services ====
NEW svn8656:05/22/2013
{{Optional/en}}

lb_whitelist_services = <services>,<services>....

reader assignement to service group for channels which may never be blocked by the loadbalancer to the reader , default=none 
 
 
==== lb_force_fallback ====
{{Optional/en}}

NEW - svn9739:05/19/2014

lb_force_fallback = 0|1

1 = set the reader always as fallback for load blancing without considering the readers statistics 

0 = default
 
 

==== ccc ====

===== cccversion =====
{{Depends/en}}

'''Only for CCcam'''

define CCcam version
<nowiki><mainversion>,<version>,</nowiki>

Example
cccversion = 1.2.34

===== cccmaxhops =====
{{Depends/en}}

define CCcam maximum SC distance hops
0 = local SCs only
1 = local SCs and + 1 hop
2 = local SCs and + 2 hops
and so on
default = 10

===== ccchop =====
{{Depends/en}}

ccchop = hop

Set hop for '''non''' CCCam readers

default = 0

===== cccreshare =====
{{Depends/en}}

CHANGE svn8607:04/10/2013

Define reader's CCcam reshare hop

cccreshare = -1 # no resharing
= 0 # reshare for direct peer only
= 1 # reshare for direct peer and next level
= x # resharing for direct peer and share level x

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 !

===== cccwantemu =====
{{Depends/en}}

Request to provide emu from CCCam server, too.
cccwantemu = 1 # yes
= 0 # no (default)

===== ccckeepalive =====
{{Depends/en}}

Send keepalive messages to keep connection to remote CCCam server up
ccckeepalive = 1 # yes
= 0 # no (default)

===== cccreconnect =====
{{Optional/en}}

cccreconnect = timeout (milli-seconds)

reconnect again after ECM request timeout in milli-secons, default = 12000 milliseconds

===== cccmindown =====
{{Depends/en}}

Filters all readers with hops smaller than number
cccmindown = # number
= 0 # default

 
 

==== '''gbox''' ====
NEW svn8350:02/15/2013
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
[reader]
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 
===== device =====
{{required}}

device = Comma-separated list of values:

peer's IP or hostname
peer's port

example:
192.168.1.101,3820

 

===== password =====
{{required}}

password = 4 hex bytes, 8 chars

peer password

example:
A123BCDE

 

===== my_password =====
{{required}}

OBSOLETE svn9163:12/31/2013 '''moved to oscam.conf [gbox]'''

Passwort = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

===== gbox_reshare =====
{{Optional/en}}

Reshare-Level of local card(s), default = 0

 

===== gbox_max_distance =====
{{Optional/en}}

gbox_max_distance = max distance to receive peer cards, default = 2

 

===== gbox_max_ecm_send =====
{{Optional/en}}

gbox_max_ecm_send = send ecm to max <gbox_max_ecm_sen> peer cards, default = 3

 

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

user name of oscam gbox

example
user = gbox_client

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
'''user must also be inserted in oscam.user [account]

'''Set suitable filters (services=, caid=, ident=) in [reader] and [account] section
'''to prevent gbox instability by overflooding with too many cards

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.server

2016-12-21T08:18:42Z

Pr2: /* cooldown */ cooldowndelay no longer exist and is replaced by cooldown with 2 parameters delay and duration

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

== oscam.server ==
The server configuration file for OSCam contains reader parameters. Sections in oscam.server are recurring (more than one reader possible). At least one [reader] section is required. Examples for reader configuation you will find here [[OSCam/en/examples/Reader|example configurations]]

{{OSCamServerParameter}}

=== [reader] ===
Define local or remote reader

==== label ====
{{required}}

name for reader

Example:
label = easymouse2

==== enable ====
{{Optional/en}}
deactivate reader
0 = off
1 = On (default)

==== description ====
{{Optional/en}}

description = text

description of reader, default: [blank] none

==== protocol ====
{{required}}

reader protocol
protocol = mouse (local cardreader)
= internal (all cardreader with "device=/dev/sciX", and internal Coolstream-Reader)
= camd35|cs357x (cascading - camd 3.5-compatible remote server - udp)
= mp35
= smartreader
= serial
= cs378x (camd 3.5-compatible remote server - tcp)
= gbox
= newcamd|newcamd525
= newcamd524
= cccam
= radegast
= pcsc
= constcw
= sc8in1
= smargo

==== device ====
{{required}}

CHANGE svn8057+8059:01/04/2013

CHANGE svn8096:01/13/2013

CHANGE svn8911:09/10/2013

define local or remote reader

device = [<readertype>;]serial:serialnum|bus:device|<device|device:slot>|<ip|hostname>,<port>[,<lport>]|pcsc|<0|1>>|constantcw

set reader type

readertype:
SR: Smartreader+ (default)
SRv2: Smartreader V2
Infinity: Infinity USB
TripleP1: Smargo Triple Reader port 1
TripleP2: Smargo Triple Reader port 2
TripleP3: Smargo Triple Reader port 3

bus:device: bus name and device name of the smartreader+
(get the name with lsusb 'Bus' ans 'Device')

serialnum: Serial-Nummer des Smartreader+ or Ininity USB (get the serial number while starting OSCam)

device: device name

device:slot: device name and slot number sc8in1 /1-8)
(only one sc8in1 reader supported)

ip|hostname: IP address or host name

port: TCP/IP port

lport: remapping to local TCP/IP port

PCSC: number of PCSC reader, starting with 0

0|1: ''' for Coolstream HD-1 STB only''': select reader 0 or reader 1

constantcw: constant CW file name

CW-File-Format:
'''Standard'''
CAID:Provider ID:Service ID:PMT ID:ECM PID::key (16 Bytes seperated by spaces)
example:
1234:123456:1234:2345:3456::00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

'''Extended OSCam-Format'''
CAID:Provider ID:Service ID:PMT ID:ECM PID:Video PID:key (16 Bytes seperated by spaces)
example:
1234:123456:1234:2345:3456:7890:00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

Examples for device parameters
device = /dev/ttyS0 # (Reader on COM1 (Linux i386 and Windows))
device = /dev/tts/1 # (Reader on COM2 (Linux dbox2 with multicam))
device = /dev/ttyUSB0 # (Reader on USB (Linux i386))
device = /dev/ttyUSB0:1 # Slot 1 SC8in1 or MCR 4/8 (Linux i386)

'''Attention:''' Counting begins with 0, that means number of device is one less than number of COM-Port! Eg ttyS0 = COM1, tts/1 = COM2.

==== detect ====
{{Depends/en}}

status detect of card '''is in'''
analysis by fun7:

Detect = CD - Carrier Detect, is a line that is used by the switch (open / closes a circuit)
for '''protocol = mouse'''
'''default'''

Detect = DSR - Data Set Ready: is a V24 / (RS232) interface signal that is transmitted on PIN 6 of a D-SUB connector.
I guess the detection itself has to be processed by the cardreaders ICs itself and is later on beeing
transmitted on pin6.

Detect = CTS - Clear To Send) - RTS - Ready to send : A RTS (ready to send) request is beeing send out from the reader.
Usually the oscam will answer with a '''CTS''' (clear to send) response, telling its ready to receive.
That feature had a common use on analog modems in the past.

Detect = RING - Ring Indicator: this describes a so called RING indicator - like the ring of a telephone - that is specified
in the RS232 specs to signalize an incoming call. In the context of oscam this should mean: reader is ringing
the oscam after card insertion, telling the oscam its desire to create a data connection. Like the word "ring"
indicates, this was used in serial connections of modems as well.

Detect = NONE - detect switched off, but signal "card is in"

Detect = GPIO - GPIO means "general purpose input output". Used for '''mipsel-uclib''', I could imagine this could be useful if
you want to play around with a '''raspberry pi''' and transmit the cardstatus to its gpio pin.
[gpio1,...gpio7]

* Inverse = prefix "!"(eg "detect=!CTS")

example
[reader]
label = mymouse
description = mymouse xxx
'''protocol = mouse'''
device = /dev/ttyUSB0 (easymouse 2)
services = xxx
boxkey = 1122334455667788
force_irdeto = 1
'''detect = cd'''
mhz = 1000
cardmhz = 600
group = 1,2,3
emmcache = 1,3,2

==== cardmhz ====
{{Depends/en}}
CHANGE svn7046:06/12/12

set standard SC frequency in units of 10 kHz, for Irdeto SC set to 600, refer to [[OSCam/en/examples/Overclocking|Overclocking]]
Example:
cardmhz = 600 # Irdeto card
= # [blank] 357 (default)

'''INTERNAL READERS'''

If you use cardmhz >2000 OScam will switch to PLL clocking. Internal readers of boxes from Dream Multimedia GmbH can be clocked more precise with it.

The used cardmhz should reflect the highest frequency of the PLL crystal in the internal cardreader. OSCam will calculate the best PLL divider that comes nearest to the wanted user card speed specified in cardmhz.

Use the following settings:

Models with PPC-CPU (DM500/DM600/DM7000/DM7020) use "cardmhz = 3150"

Models with MIPS-CPU (DM500HD/DM800/DM800SE/DM8k/DM7020HD etc.) use "cardmhz = 2700"

DM7025 is special, use "cardmhz = 8300"

'''If only the parameter cardmhz is set (without mhz = xxx) then Oscam clocks the card automatically with the ATR! '''

E.G. You have a dream 800 HD PVR, thats a mips so you should set cardmhz to 2700. We got a nagra card that should run on 5 MHz. If

you want to clock the card ok just use cardmhz = 2700 an mhz = 500. If you want to overclock it use cardmhz = 2700 and mhz = 900.

Now your card will start to run 9 Mhz. Better monitor it! An overclocked card could run hot or crash suddenly!

Keep in mind that most internal readers of non-dreamboxes clock the cards automatically and copletely ignore any user clockspeed setting. But you should set cardmhz and mhz anyway, as its still used to calculate the correct timings in OSCam. If you set cardmhz/mhz correct the timings will better match with the actual (automatically) clockspeed of the internal card reader. As for a result slighly better ecm responses or more stable functioning.

Dont expect magic here, only overclocking the cardspeed can reduce the ecm response time. Bad timings can only delay it or make the card responses instable!
[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== mhz ====
{{Optional/en}}
CHANGE svn 9064:12/13/2013

set reader frequency in units of 10 kHz, if mhz > cardmhz you are in overclocking mode, refer to [[OSCam/en/examples/Overclocking|Overclocking]]

Example:
# Default 357
cardmhz = 600 # ( 6000 KHz = 6 MHz)
mhz = 1000 # (10000 KHz = 10 MHz)

auto clock speed in '''Dreambox mode''' set to -1. Further Informations about the various (Dream)Boxes can be found [http://www.streamboard.tv/oscam/wiki/ReaderClocks here].

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== autospeed ====
{{Optional/en}}
NEW svn9064:12/01/2013

autospeed = 0|1

autospeed = 0 disabled
autospeed = 1 (default) Sets mhz according to ATR. Currently only used for smartreader, smargo protocol and Dreambox-readers internal protocol. Other readers will be adapted to use this
parameter as well. In webif checked means 1. If you want to overclock your card set autospeed to 0.

==== deprecated ====
{{Optional/en}}
First the SC will be initialized in normal mode. If it fails, the SC will be automatically reverted to deprecated mode, so that the SC speed will not be changed and the communication will remain on normal ATR speed of 9600 baud.

deprecated = 1 use deprecated SC mode only
= 0 default

==== mode ====
{{Depends/en}}
set card init mode for '''AzBox''' reader
mode = 1 # AzBox-Reader
= 0 # none (default)

==== device_out_endpoint ====
{{Depends/en}}

CHANGE svn8013:12/29/2012

set endpoint address for FTDI chips
device_out_endpoint = 0x81 # Smargo Triple Reader port 1
= 0x82 # Smartreader+ (default)
= 0x83 # Smargo Triple Reader port 2
= 0x85 # Smargo Triple Reader port 3

==== smargopatch ====
{{Optional/en}}
NEW svn6402:02/16/2012

smargopatch = 0|1

enable workaround for smartreader+ and reader until native mode works, default = 0

==== sc8in1_dtrrts_patch ====
{{Optional/en}}
NEW svn6402:02/16/2012

sc8in1_dtrrts_patch = 0|1

enable fix for SC8in1/MCR DTR/RTS kernel bug, default = 0

==== cool_timeout_init ====
{{Optional/en}}
NEW svn6286:01/23/2012

cool_timeout_init = timeout in milli seconds, default = 0

set card init mode for '''AZBox''' internal reader

==== cool_timeout_after_init ====
{{Optional/en}}
NEW svn6253:01/17/2012

[[Datei:WarningS.png|text-bottom]] '''Attention: only for Coolstream!'''

cool_timeout_after_init = timeout in milli seconds, default = 0

set read/transmit timeout after SC init in milli-seconds for Coolstream internal reader only, default:150

==== ins2e06 ====
{{Optional}}
NEW svn9568:03/16/2014
add check control for pin payload (4 hex bytes) for NDS Videoguard 2 SCs
ins2e06 = Payload
= # none [blank] (default)
[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only
http://www.streamboard.tv/oscam/changeset/9568

==== ins7e ====
{{Optional/en}}
NEW svn5959:09/22/2011

ins7e = payload
= [none] default
Add 26 hex-bytes payload for '''NDS Videoguard 2 SCs'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only

==== ins7e11 ====
{{Optional/en}}
NEW svn6064:12/06/2011

ins7e11 = TA1 Byte
= # [none] default
= 11 # 0001 FI + 0001 DI (1 x)
= 13 # 0001 FI + 0011 DI (4 x)
= 14 # 0001 FI + 0100 DI (8 x)
= 15 # 0001 FI + 0101 DI (16 x)

Add TA1 Byte for '''NDS Videoguard 2 SCs'''

[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only
 
==== fix07 ====
NEW svn9884:09/30/2014
{{Optional/en}}
enable 0x07 fix for NDS Viedeoguard 2 SCs
fix07 = 1 # enabled (default)
= 0 # disabled
[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only

==== force_irdeto ====
{{Optional/en}}

force Irdeto SC mode even if RSA key is set for Irdeto tunneled Nagravion SC
force_irdeto = 1 # yes
= 0 # no (default)

==== nagra_read ====
{{Optional/en}}

read '''Nagravison''' records (on NCMED cards only):
nagra_read = 0 # disabled (default)
= 1 # read all records with expired rights
= 2 # read records with valid rights only

==== rsakey ====
{{Optional/en}}
CHANGE svn7046:06/12/12

RSA key for Nagravision/Tiger SCs / CAM key data for Irdeto SCs, Conax SCs, default = none

==== fix9993 ====
{{Optional/en}}

fix9993 = 0|1

enabled fix for 9993 error with CAID 0919 SCs.

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

==== readtiers ====
{{Optional/en}}
NEW svn10376:02/02/15

readtiers = 0|1|2

method to get tiers of NDS Videoguard SCs

readtiers = 0 # disabled (default)
readtiers = 1 # ins70 (new) method
readtiers = 2 # ins76 (old) method

==== boxkey ====
{{Optional/en}}
box key for Nagravision SCs / CAM key for Irdeto SCs / sessionkey for Seca SCs / CamID for Viaccess

==== pincode ====
{{Optional/en}}

pincode for '''Conax, Cryptoworks an Viaccess''' SCs
pincode = pincode
= # [blank] default

==== boxid ====
{{Optional/en}}

NDS receiver box id
boxid = NDS box ID

==== ndsversion ====
{{Optional/en}}

set NDS '''Videoguard''' version
0 = # autodetection (default)
1 = # NDS Videoguard 1
12 = # NDS Videoguard 1+
2 = # NDS Videoguard 2

==== aeskeys ====
{{Optional/en}}

multiple 16 bytes AES keys for Viaccess SCs (the used postprocessing AES key is specified through the D2 nano of the ECM)

CAID #ident:AES key #0 CAID #0[,AES key #1 CAID #0],...[;CAID #1@ident::AES key #0 CAID #1[,AES key #1 CAID #1],...]...

special AES keys:
00 = do not return any CW, no AES key specified
FF = return CW received from the S, no AES key specified

Example:
aeskeys = 0500@012345:000102030405060708090a0b0c0d0e0f;0500@543210:0,0,0f0e0d0c0b0a090807060504030201
aeskeys = 0500@012345;key0,key1,key2,key3,key4,key5,...;0500@543210:key0,key1,key2,key3,key4,key5,...
if keys are unknown replace them with 0 exemple: 0500@012345;key0,key1,0,0,key4,key5,...

==== showcls ====
OBSOLETE svn6624:04/23/2012
{{Optional/en}}

number of classes subscriptions to show for '''Viacces-SCs'''
schowcls = quantity
= 0 # (default)

==== key ====
{{Depends/en}}
key for newcamd remote reader encryption
key = DES key

==== user ====
{{Optional/en}}
user for remote reader (name)

==== password ====
{{Optional/en}}
password for remote reader

==== mg-encrypted ====
{{Optional/en}}

VERALTET - OBSOLETE - OBSOLÈTE - ANTIQUATO

mgcamd encrypted '''gbox line'''

format:

{ <IP|hostname> { <local port> <remote port> { <password> { <level> <level> } address> }

default:
MAC address=eth0

==== services ====
{{Optional}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If loadbalancing is enabled in oscam.conf [global] among lb_mode, then there may be '''no entries'''!

[[Datei:WarningS.png|text-bottom]] '''Attention:''' The number of services that will be considered based reader, is limited to 64, or 64 times [[service-name][CAID][provid][srvid]]!

What services can the reader. This requires a oscam.services be present. The logic here is as follows (in this order):
* If the field is empty (or invalid), the request is allowed.
* When a negative service (ie, those with "!") is applicable, the request is rejected.
* If a positive service is applicable or there is no positive service, the request is allowed.
* If none of the previous points, the request is rejected.
This means that negative Services are only necessary in individual cases. Namely, if and when services has positive, but it wants to exclude some back. This is not recommended, because here comes quickly to misconfigurations. Instead, an additional service to be created that contains all the relevant channels.

[de]assignment to service group
services = [!]services[,[!]<services>]...
= [blank] is default

==== caid ====
{{Optional/en}}

caid = <CAID>[&<mask>][:<target CAID>][,<CAID>[&<mask>][:target <CAID>]]...

define and mapping of CAIDs for reader, default:all CAIDs with mask FFFF

example:
caid = 0100
caid = 0200&ffee:0300
caid = 0400&ff00:0500,0600
caid = 0702,0722
caid = 0702&ffdf (shortcut for the example above)

==== ident ====
{{Optional/en}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' If in oscam.conf [global] loadbalancing is enabled among lb_mode, then there may be '''no entries'''! 
This parameter is only used for EMM and then it is not used for ECM. So you cannot force ECM to be sent to the card using this parameter. 

define CAID and ident '''SC specific''' for reader:
ident 0 <CAID>:<ident>[,ident]...[;<CAID>:<ident>[,ident]...]...

Example
ident = # 0100:123456,234567;0200:345678,456789
= # [blank] no definition (default)

==== class ====
{{Optional/en}}

define class '''in hex''' SC specific for reader:
class = 01,02,!1b,!2b # 01 and 01 yes, 1b and 2b no
= # [blank] no definition (default)

==== localcards ====
{{Optional/en}}

Use this reader (for defined CAIDs only) as "local" in LB/reader selection.
It will be handle as a local reader per LB and preferlocalcards settings. In this way, we can consider a network reader as local, like we had a cardreader.

localcards = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]....

==== chid ====
{{Optional/en}}

define '''Irdeto ChID''' for reader

Example:
chid = 0100:12
chid = 0100:12;0604:0000BA,000101,00010E,000141
= # [blank] default

==== group ====
{{required}}
CHANGE svn6103:12/21/2011

Reader assingment to group. Each reader must be listed in one or more groups. This will determine, which client has access on what reader. Valid values 1-64
group = 1....64[,1....64]....

'''set required = [blank] default not allowed!'''

Example:
Group = 1 # (one group)
Group = 1,4,5 # (more groups)

==== audisabled ====
{{Optional/en}}

exclude reader from auto AU (auto update)
audisabled = 1 # excludet
= 0 # not excludet (default)

==== auprovid ====
{{Optional/en}}
set provider ID to use the right reader for auto AU

Example
auprovid = # 123456
= # [blank] default

==== disableserverfilter ====
{{Optional/en}}
ignore caid and ident settings of reader due faulty clients
disableserverfilter = 1 # ignore
= 0 # not ignore (default)

==== inactivitytimeout ====
{{Depends/en}}
inactivity timeout in seconds

inactivitytimeout = seconds
= -1 # reconnect on network failure for '''newcamd''' based readers, even in idle
= 0 # default

==== reconnecttimeout ====
{{Optional/en}}

CHANGE svn7244:08/07/2012

Reconnect from a remote reader, if missing answers in seconds

Example
reconnecttimeout = 20 # after 20 seconds new connection
= # [blank] default

==== connectoninit ====
{{Optional/en}}
NEW svn8235:01/29/2013

connectoninit = 0|1

1 = allow newcamd connections to be established on starup although there isn't a request yet
0 = default

==== keepalive ====
{{Optional/en}}
NEW svn9810:07/22/2014

keepalive = 0|1

1 = allow cs378x TCP socket to be always connected
0 = always on if cacheex reader type

==== fallback ====
{{Optional/en}}

Define reader as fallback, standard and fallback reader must have the same group, see '''group'''!
fallback = 1 # fallbackreader
= 0 # no fallbackreader (default)

==== fallback_percaid ====
{{Optional/en}}
NEW svn8896:09/04/2013

fallback_percaid = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]...

use reader as fallback for defined CAIDs only, two digit wildcards CAIDs are possible, fallback_percaid overrules fallback. Def.=none

example:
fallback_percaid = 1234:234567;10:345678

==== emmcache ====
{{Optional/en}}

set EMM cache of local reader

[[Datei:WarningS.png|text-bottom]] '''Attention:'''

Without this parameter, no EMM are shown in the log!

Format:
'''''emmcache = <usecache>,<rewrite>,<logging>,<stb-emm>'''''

* <usecache> 0 = # disable usage of emmcache and emmstats (default)
* <usecache> 1 = # enable emmcache, emmstats and save to file if oscam is stopped
* <usecache> 2 = # enable emmcache, emmstats but dont save to file if oscam is stopped

* <rewrite> n = # determines how often one and the same EMM is written. '''only if <usecache> = 1 or 2'''

* <logging> 0 = # EMM logging disabled
* <logging> 1 = # logging EMM errors
* <logging> 2 = # logging written EMMs
* <logging> 4 = # logging skipped EMMs
* <logging> 8 = # logging blocked EMMs
* <logging> 16 = # logging audisabled EMMs

* <stb-emm> 0 = # EMM for STB are ignored (default)
* <stb-emm> 1 = # EMM for STB are sent to the reader (very specific usage)

Sumarizing this values is possible. 31 shows all kinds of messages.

Example:
emmcache = 1,3,10,0 # Cache on, write 3 x, log written (2) and blocked (8) = 10 , don't send stb-emm
emmcache = 1,2,6,1 # Cache on, write 2 x, log written (2) and skipped (4) = 6, send stb-emm

'''stb-emm''': is only handy for specific usage (Viaccess: see commit [http://www.streamboard.tv/oscam/changeset/10584 #10584] ) In Viaccess we saw some EMM-G that are for the STB and not for the card. That's why we call it EMM-STB (Set Top Box). Those EMMs are, for exemple, used to define overencryption key (AES) into the STB to encrypt STB-Card dialog.
 

==== emmreassembly ====
{{Optional/en}}
NEW svn8493:03/06/2013

OBSOLETE svn8591:04/01/2013 parameter now in oscam.user!

emmreassembly = 0|1

1 = enable EMM reassembly, default
0 = disable EMM reassembly

should be set for Viaccess and Cryptoworks readers if the client that you are using to send EMMs is reassembling than instead of just sending them to OSCam for processing

 

==== cacheex ====
{{Optional/en}}
NEW svn6044:11/27/2011

cacheex = 0|1|2|3

1 = enable cache exchange pull mode
2 = enable cache exchange push mode
3 = enable cache exchange reversepush mode
0 = default
for camd 3.5x and CCcam protocol

see also on oscam.user!

Identical cache exchange modes must be set on local OSCam server and remote OSCam user account!

===== cacheex-modes =====
===== cacheex = 1 - cachepull =====
Situation:

OSCam A reader1 has cacheex = 1

OSCam B account1 has cacheex = 1

OSCam A gets a ECM request, reader1 send this request to OSCam B,

OSCam B checks his cache:
* Not found in cache: return NOK
* Found in cache: return OK+CW
* Not found in cache, but found pending request: wait ''cacheexwaittime'' in oscam.conf [global] and check again. OSCam B never requests new EMMs.

CW-flow = B ---> A

===== cacheex = 2 - cachepush =====
Situation:

OSCam A reader1 has cacheex = 2

OSCam B account1 hastcacheex = 2

If OSCam B gets a CW, its pushed to OSCam A, reader has normal functionality and can request ECMs.
* Problem: OSCAM can only push CW's if OSCam A is connected
* Problem or feature?: OSCam A reader can request ECMs from OSCam B

CW-flow = B ---> A

===== cacheex = 3 - reversecachepush =====
Situation:

OSCam A reader 1 has cacheex = 3

If OSCam A gets a CW, its pushed to OSCam B. OSCam A never requests new ECMs.

CW-flow = A ---> B

==== cacheex_maxhop ====
{{Optional/en}}
NEW svn6691:05/07/2012

cacheex_maxhop = hops
= default = 10 hops

define maximum hops for cach exchange

==== logport ====
{{Optional/en}}

Camd 3.x reader logport, camd 3.x UDP must be activated, only works if there's no camd 3.x cascading
logport = # port number
= 0 # disabled (default)

==== ecmwhitelist ====
{{Optional/en}}

ecmwhitelist = [CAID[@provid]:]length[,length]...[;[CAID[@provid]:]length[,length]...]...

define valid ECM length in '''hex''' and provid for physical reader

example
ecmwhitelist = 10,20,30,0a,0b,0c
= 0100:10,20;0200@12345:0a,4b
[blank] = none (default) and provid 000000

[[Datei:WarningS.png|text-bottom]] '''In normal operation mode this parameter ist not required!'''

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/ECMLengthList|List of ECM lengths]]'''

==== ecmheaderwhitelist ====
{{Optional/en}}
NEW svn7480:09212012

ecmheaderwhitelist = [CAID[@provid]:]header[,header...[;[@provid]:]header[,header]...]...

set valid ECM header per CAID and provid '''in hex'''

default: none, provid = 000000

thread [[Streamboard-Thread:34748|here]]

[[Streamboard:oscam/wiki/HeaderWhitelist|HeaderWhitelist]] here

==== ratelimitecm ====
{{Optional/en}}

number of different SIDs in ECMs allowed for an interval
ratelimitecm = # number
= 0 # (default)

==== ecmnotfoundlimit ====
{{Optional/en}}
NEW svn8313:02/07/2013

ecmnotfoundlimit = count

number of ECMs with "not found" answer until the reader will be restarted, 0 = no limit (default)

==== resetcycle ====
{{Optional/en}}
NEW svn5820:08/12/2011

resetcycle = count

number of ECMs until SC reset ist performerd

[[Datei:WarningS.png|text-bottom]] '''Hint:''' Valid for physical readers only!

example:
resetcycle = 0 # disabled [default]
= 5 # reset after 5 ECM's

==== ratelimittime ====
{{Optional/en}}
NEW svn9078:09/12/2013

interval for rate limit in milliseconds
ratelimittime = # milliseconds
= 0 # (default)
 

==== ecmunique ====
{{Optional/en}}
NEW svn8491:03/06/2013

ecmunique = 0|1

1 = enable check for matching ECM hash in ratelimit slot
0 = default

 

==== srvidholdtime ====
{{Optional/en}}
NEW svn9078:09/12/2013

srvidholdtime = milliseconds

time to keep service ID in ratelimit slot, during this time checking for ecmunique ist disabled.
0 = default
 

==== cooldown ====
{{Optional/en}}

cooldown = delay, duration

define cooldown:
delay = delay in milliseconds for which the reader is allowed to do more
ECM requests then defined by parameter "ratelimitecm"
default: [blank] none
duration = duration in milliseconds the reader needs to cooldown
default: [blank] keine

Both parameters are mandatory when used.

'''parameter "ratelimitecm" and "ratelimittime" are required!'''

==== blocknano ====
{{Optional/en}}
list of EMM-nanos to block (in hex w/o 0x) or all EMM-nanos, only valid for physical readers!

Example:
blocknano = 45,93,7a,ff
= all
= # [blank] (default)

==== blockemm-u ====
{{Optional/en}}

block unique EMMs
blockemm-u = 0 # (no block) default
blockemm-u = 1 # (block EMMs, which are addressed to card immediatly) )

==== blockemm-s ====
{{Optional/en}}

block shared EMMs
blockemm-s = 0 # (no block) default
blockemm-s = 1 # (block EMMs, which are addressed to certain groups of cards)

==== blockemm-g ====
{{Optional/en}}

block global EMMs
blockemm-g = 0 # (no block) default
blockemm-g = 1 # (block EMMs, which are addressed to all cards)

==== blockemm-unknown ====
{{Optional/en}}

block unknown types of EMMs
blockemm-unknown = 0 # (no block) default
blockemm-unknown = 1 # (block all unknown kinds of EMMs)

==== blockemm-bylen ====
{{Optional/en}}

CHANGE svn8615:04/12/2013

blockemm-bylen = [length range,length range]... (decimal)

block all types of EMMs by length, maximum 10 values, default: none

example:
blockemm-bylen = 1-10,11-

 

==== via_emm_global ====
{{Optional/en}}

NEW svn9843:09/05/2014

via_emm_global == 0|1

enables global emm filter for '''viacces'''

'''only for camd35 (cs357x) protocol!'''

0 = default

 

====saveemm-u ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-u = 0 (default)
= 1

save unique EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

====saveemm-s ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-s = 0 (default)
= 1

save shared EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

====saveemm-g ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-g = 0 (default)
= 1

save global EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

====saveemm-unknown ====
{{Optional/en}}
NEW svn5947:09/09/2011

saveemm-unknown = 0 (default)
= 1

save unkown EMMs to file. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

==== savenano ====
{{Optional/en}}

OBSOLETE svn5947:09/09/2011

list of EMM-nanos (in hex w/o 0x) to save or all EMM-nanos. Only valid for physical readers. The path can be defined with "emmlogdir=" in oscam.conf (default=config-dir).

Format
nano[,nano]....|all

Beispiel
savenano = 45,93,7a,ff
= all
= # [blank] default

==== readnano ====
{{Optional/en}}
Write file (usually a copy of a file saved by savenano) to your smartcard, if no path is specified, the specified file is searched for in the configuration directory, only valid for physical readers!

Example:
readnano = write.emm
= /var/oscam/write.emm
= # [blank] (default)

==== use-ssl ====
{{Optional/en}}

NEW svn8725:06/25/20113

use_ssl = 0|1

use_ssl = 1 # use SSL for ghttp protocol
= 0 # default

==== dropbadcws ====
{{Optional/en}}

CHANGE svn5992:10/22/2011

dropbadcws = 0|1

dropbadcws = 1 # reject bad CWs, send "not found" instaed of bad CWs
= 0 # default

==== disablecrccws ====
{{Optional/en}}

NEW svn6004:10/26/2011

disablecrccrws = 1 # disable cw checksum test
= 0 # enable (default)

==== lb_weight ====
{{Optional/en}}

The higher the value the higher the probability for reader selection. It's an divider for the average responstime.
lb_weight = weight
= # [blank] Default-Wert 100

See here
[[Datei:Lb_weight_calc2.png]]

==== lb_whitelist_services ====
NEW svn8656:05/22/2013
{{Optional/en}}

lb_whitelist_services = <services>,<services>....

reader assignement to service group for channels which may never be blocked by the loadbalancer to the reader , default=none 
 
 
==== lb_force_fallback ====
{{Optional/en}}

NEW - svn9739:05/19/2014

lb_force_fallback = 0|1

1 = set the reader always as fallback for load blancing without considering the readers statistics 

0 = default
 
 

==== ccc ====

===== cccversion =====
{{Depends/en}}

'''Only for CCcam'''

define CCcam version
<nowiki><mainversion>,<version>,</nowiki>

Example
cccversion = 1.2.34

===== cccmaxhops =====
{{Depends/en}}

define CCcam maximum SC distance hops
0 = local SCs only
1 = local SCs and + 1 hop
2 = local SCs and + 2 hops
and so on
default = 10

===== ccchop =====
{{Depends/en}}

ccchop = hop

Set hop for '''non''' CCCam readers

default = 0

===== cccreshare =====
{{Depends/en}}

CHANGE svn8607:04/10/2013

Define reader's CCcam reshare hop

cccreshare = -1 # no resharing
= 0 # reshare for direct peer only
= 1 # reshare for direct peer and next level
= x # resharing for direct peer and share level x

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 !

===== cccwantemu =====
{{Depends/en}}

Request to provide emu from CCCam server, too.
cccwantemu = 1 # yes
= 0 # no (default)

===== ccckeepalive =====
{{Depends/en}}

Send keepalive messages to keep connection to remote CCCam server up
ccckeepalive = 1 # yes
= 0 # no (default)

===== cccreconnect =====
{{Optional/en}}

cccreconnect = timeout (milli-seconds)

reconnect again after ECM request timeout in milli-secons, default = 12000 milliseconds

===== cccmindown =====
{{Depends/en}}

Filters all readers with hops smaller than number
cccmindown = # number
= 0 # default

 
 

==== '''gbox''' ====
NEW svn8350:02/15/2013
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
[reader]
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 
===== device =====
{{required}}

device = Comma-separated list of values:

peer's IP or hostname
peer's port

example:
192.168.1.101,3820

 

===== password =====
{{required}}

password = 4 hex bytes, 8 chars

peer password

example:
A123BCDE

 

===== my_password =====
{{required}}

OBSOLETE svn9163:12/31/2013 '''moved to oscam.conf [gbox]'''

Passwort = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

===== gbox_reshare =====
{{Optional/en}}

Reshare-Level of local card(s), default = 0

 

===== gbox_max_distance =====
{{Optional/en}}

gbox_max_distance = max distance to receive peer cards, default = 2

 

===== gbox_max_ecm_send =====
{{Optional/en}}

gbox_max_ecm_send = send ecm to max <gbox_max_ecm_sen> peer cards, default = 3

 

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

user name of oscam gbox

example
user = gbox_client

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
'''user must also be inserted in oscam.user [account]

'''Set suitable filters (services=, caid=, ident=) in [reader] and [account] section
'''to prevent gbox instability by overflooding with too many cards

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2016-12-20T20:02:40Z

Pr2: /* WebIf */ Add httpshowloadinfo

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

==== httpshowmeminfo ====
{{Optional/en}}

httpshowmeminfo = 0|1
1 = display memory usage informations in Status screen
0 = do not show (default)

==== httpshowloadinfo ====
{{Optional/en}}

httpshowloadinfo = 0|1
1 = display load average and CPU usage informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port[,port]... own gbox port

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2016-12-20T20:00:46Z

Pr2: /* WebIf */ Add httpshowmeminfo

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

==== httpshowmeminfo ====
{{Optional/en}}

httpshowmeminfo = 0|1
1 = display memory usage informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port[,port]... own gbox port

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2016-12-20T19:59:33Z

Pr2: /* WebIf */ Add httpshowcacheexinfo

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

==== httpshowcacheexinfo ====
{{Optional/en}}

httpshowcacheexinfo = 0|1
1 = display CacheEX informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port[,port]... own gbox port

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2016-12-20T19:57:33Z

Pr2: /* WebIf */ Add httpshowuserinfo

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

==== httpshowuserinfo ====
{{Optional/en}}

httpshowuserinfo = 0|1
1 = display users informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port[,port]... own gbox port

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2016-12-20T19:56:10Z

Pr2: /* WebIf */ Add httpshowecminfo

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

==== httpshowecminfo ====
{{Optional/en}}

httpshowecminfo = 0|1
1 = display readers and users ECM informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port[,port]... own gbox port

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2016-12-20T19:54:26Z

Pr2: /* WebIf */ Add httpshowreaderinfo

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

==== httpshowreaderinfo ====
{{Optional/en}}

httpshowreaderinfo = 0|1
1 = display readers informations in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port[,port]... own gbox port

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2016-12-20T19:51:03Z

Pr2: /* WebIf */ Add http_status_log

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

==== http_status_log ====
{{Optional/en}}

http_status_log = 0|1
1 = display log in Status screen
0 = do not show (default)

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port[,port]... own gbox port

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2016-12-20T19:43:51Z

Pr2: Goup hideclient parameters in the wiki since they are linked together

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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!

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

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== 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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port[,port]... own gbox port

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2016-12-20T19:41:05Z

Pr2: /* httpiconpath */ correct a typo httpiconpath -> httppiconpath

[[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)
1 = detailed error messages
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 = DVB API logging
256 = load balacing logging
512 = cache exchange logging
1024 = client ECM logging
65535 = debug all

===== initial_debuglevel =====
{{Optional/en}}
NEW svn10705:06/11/15

Set the debuglevel on startup.

Example:
initial_debuglevel = 8

Default:
initial_debuglevel = 0

===== pidfile =====
{{Optional/en}}
NEW svn:8176/01/24/2013

pidfile = set pidfile, [blank] none (default)

Change PID file name an path. If default = oscam.pid in /tmp

Example:
pidfile = /var/run/oscam.pid

===== 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

===== ecmfmt =====
{{Optional/en}}
NEW svn6649+6653:05/01/2012

CHANGE svn8831:08/11/2013

CHANGE svn11008-11011:09/28/15

CHANGE svn11273:08/15/16

ecmfmt = format

define ECM log format, default:c&p/i/s/l:h

possible variables:
c = CAID
d = PID
e = CSP hash
g = ID of origin gbox peer
h = checksum
i = Channel ID
j = distance of gbox and CCcam hops
l = length
o = ONID
p = provider ID
s = service ID
t = tier ID , this ID will be replaced with the tier-description from oscam.tiers (if found)
w = CW
y = payload (short, 3 bytes)
Y = payload (long, 6 bytes)

use a value as prefix to hide variable with this value, control characters will be escaped by "\"

example:
ecmfmt = c&0p/i/d/s/l:h.e_w HOP:j
(hide provider ID if 0)

===== nds_swap_cw =====
{{Optional/en}}

NEW svn:10003/11/15/2014

OBSOLETE svn10048:11/30/2014

nds_swap_cw = 0|

0 = NDS Videoguard CWs will be dropped, if CWs do not have an odd an even sample (default)
1 = disabled

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

===== CACHE EXCHANGE LOGGING =====
NEW svn6929:05/24/2012

CACHE EXCHANGE LOGGING
reader stages
1 = cacheex (=1) reader (C)
2 = local SCs (L) #stage 2 is used only if '''preferlocalcards = 1''' was activated in [global] section.
3 = other reader / proxies (P)
4 = fallback reader (F)

logging format
stage/used/chosen/possible

example

P/2/2/2 or L/2/4/4

===== 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)

===== logduplicatelines =====
{{optional/en}}
NEW svn:8290/02/05/2013

logduplicatelines = 0|1

1 = disable detection of duplicate lines in log file
0 = enable detection of duplicate lines in logfile = 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}}

OBSOLETE svn7128:07/02/2012

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

===== cacheex_mode1_delay =====
{{Optional/en}}

NEW svn:10050/11/30/2014

cacheex_mode1_delay = CAID1:time,[CAID2:time]...

delay in millisencons for asking cache exchange mode 1 readers, default: none

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

disablemail = 0|1

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

===== sysloghost =====
{{Optional/en}}
NEW svn10703:06/11/15

If set remote syslog server will be activated. Messages will be sent to this IPv4 address. If not set remote syslog server not work.

Example:
sysloghost = 192.168.1.167

===== syslogport =====
{{Optional/en}}
NEW svn10703:06/11/15

If set ''sysloghost'' remote syslog server will be activated. Messages will be sent to this port. If not set port 514 is used as default.

Example:
syslogport = 515

Default:
syslogport = 514

==== Reader ====

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

NEW svn6285:01/23/2012

LED-Support

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}}

OBSOLETE svn8541:03/13/2013

'''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}}
CHANGE svn9605:03/29/2014

try decoding on local cards first

Example:
preferlocalcards = 0 # local cards are used like remote reader
preferlocalcards = 1 # prefer CacheEx sources
preferlocalcards = 2 # prefer local cards

Default:
preferlocalcards = 1 # prefer CacheEx sources

===== 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

===== block_same_ip =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_ip = 0|1

1 = reject looping ECM's from clients to reader with the same ip address, default = 1
0 = no reject

===== block_same_name =====
{{Optional/en}}

NEW svn7215:07/27/2012

block_same_name = 0|1

1 = reject looping ECM's from clients to reader with the same name, default = 1
0 = no reject

==== Cache ====

===== cachedelay =====
{{optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] delay

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

===== max_cache_time =====

{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_time

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

===== max_cache_count =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache] max_count

max_cache_count = count, default 1000

maximum CWs in cache

===== cacheexwaittime =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013

cacheexwaittime = delay

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

===== cacheexenablestats =====
{{Optional/en}}
OBSOLETE svn8358:16/02/2013 move to [cache]

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 in milli-seconds for client process to wait for key

Examples:
clienttimeout = 10000 # after 10 seconds timeout
clienttimeout = 10 # timeout after 10 milli-seconds! (see Tip below)
clienttimeout = 8 # timeout after 8000 milli-seconds (= 8 seconds), see Tip below
Default:
clienttimeout = 5000 # timeout after 5000 milli-seconds (=5 seconds)

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Values < 10 (so 1 to 9) are multiplicated with 1000, so a "5" results in 5000 ms.

===== 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

==== 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.

==== fallbacktimeout_percaid ====
{{Optional/en}}
NEW svn:8896/09/04/2013

fallbacktimeout_percaid = milliseconds

time falling back to CAID restricted fallback reader, default: 2500

==== 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 - This sets the value of SO_PRIORITY on network connections. Basically this leads to setting the TOS fields of the sent IP packages so that QoS can be better used.

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

set mode for DNS resolving: These are different libc calls to resolve dns names and some older systems have problems with the newer implementation ''getadressinfo'' (getadressinfo is also threadsafe whereas ''gethostbyname'' is not and thus it has some locks around) or have stripped them from their images (dbox2 was such a candidate I think) even though it is available at compile time.
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}}
CHANGE svn7289:08/27/2012

'''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

==== double_check_caid ====
{{Optional}}
NEW svn:7237/08/05/2012

double_check_caid = [CAID1|first two digits of CAID1],[CAID2|first two digits of CAID2]...

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 CAID, lb_nbest_readers must be set to 2 or higher, default:none

==== 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
lb_mode = 10 LB is switched off, but statistics are build

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}}

OBSOLETE svn8642:05/10/2013

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_reopen_invalid =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_reopen_invalid = 0|1

0 = E_INVALID wiil be blocked until statistics has been cleaned
1 = default

===== lb_force_reopen_always =====
{{Optional/en}}

NEW svn:9885:09/30/2014

lb_force_reopenalways = 0|1

1 = force reopening immidiatly all failing readers if no matching was found
0 = default

===== 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_noproviderforcaid = 12,34,5678
(wildcard CAIDs 12xx and 34xx)

default = none

===== lb_auto_timeout =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout = 0|1

lb_auto_timeout = 1 # enable automatic timeout based on load balancing statistics
= 0 # default

===== lb_auto_timeout_p =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_p = percent

percent added to average time as timeout time
default = 30

===== lb_auto_timeout_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_timeout_t = milli seconds

minimal time added to average time as timeout time
default = 300

===== 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 [[streamboard:wiki/OSCam/en/Config/oscam.user#betatunnel|User-Betatunnel]]!

===== lb_auto_betatunnel_mode =====
{{Optional/en}}

NEW svn 7784:10/22/2012

lb_auto_betatunnel_mode = 0|1|2...

set mode for automatic Betacrypt tunneling

0 = CAID 18XX tunneling to CAID 17X2 only (default)
1 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801)
2 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834)
3 = CAID 18XX tunneling to CAID 17X2 and CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835)
4 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1801 only)
5 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1834 only)
6 = CAID 17X2 tunneling to CAID 18XX (CAID 1833/1835 only)

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

NEW svn6045:11/27/2011

CHANGE svn 7768:10/21/2012

lb_auto_betatunnel_prefer_beta = number

Hier kann der Schwerpunkt für die automatische Auswahl von Betacrypt/Nagravision gewählt werden.

0 = disabled (default
1 = always Betacrypt
105 = represents the middle
200 = always Nagravision

=== 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 switched from "active" to "on" (default).

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

monitor-level
0 = no access to monitor (default)
1 = only server and own procs
2 = all procs, but viewing only
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}}

OBSOLETE svn8546:03/13/2013


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

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}}

==== File format to send EMMs via the webinterface ====
(by Bit)

[[Datei:WarningS.png|text-bottom]] '''Attention'''

* File has to be in TXT format.
* The EMM-file should contain each PRE-CAM EMM in a new line.
* EMMs should be in HEX representation.
** Example: AABBCCDD...
*Spaces and tabs between the bytes are allowed:
**AA BB CC DD...
*The HEX representation of each EMM's byte can be represented by upper or lower case - even mixed is allowed:
**AA aa Aa aA...
*Other chars and comments are not allowed.

==== 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!'''

==== http_prepend_embedded_css ====
{{Optional/en}}
NEW svn6797:05/13/2012
CHANGE svn6625:05/15/2012

http_prepend_embedded_css = 0 | 1
http_prepend_embedded_css = 0 # Do not add the content of the embedded CSS before the content of the custom CSS (default)
1 # embedded CSS will be added before external custom CSS (specified by the [[#httpcss|httpcss]] parameter)

This parameter can be used to override the embedded CSS with custom styles. To see the current CSS styles use the url: http://''url_to_oscam_webif'''''/site.css'''

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

path for external CSS file

For webinterface different styles are available. Put custom CSS files (ending with .css extension) in the oscam config directory to managed your custom styles with WebIf.

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

To see the current CSS style, use the url: http://''url_to_oscam_webif'''''/site.css'''

Styles you find here: [[Streamboard-Thread:30083|Streamboard-Thread]]

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

CHANGE svn 7083:06/25/2012

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

path for external templates and picons, multiple simultaneously templates and picons are possible by creat‐
ing sub folders (maximum length of 32 alphanumeric characters), sub folders naming is corresponding to sub
folder in URL, default:none

example
httptpl = /this/is/my/path

folder with multiple templates:
/this/is/my/path/template
/this/is/my/path/template2

valid URLs:
http://host:port/template1
http://host:port/template2
 
 
==== httpoverwritebakfile ====
{{Optional/en}}
NEW svn9858:09/21/2014

httpoverwritebakfile = 0|1

1 = overwrite backup configurations files (*.bak)
0 = default
 
 

==== httplocale ====
{{Optional/en}}
NEW svn9828:08/15/2014

httplocale = environment

set the "locale environment"

default = blank [none]

look here::

http://en.wikipedia.org/wiki/locale

==== httpjscript ====
{{Optional/en}}
NEW svn6806:05/14/2012

httpjscript = path

path for oscam.js javascript, def: none

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

status refresh in seconds

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

==== httppollrefresh ====
{{Optional/en}}

refreshtime for polling in seconds

httppollrefresh = 60 # polling will be refreshed after 60 seconds
= # [blank|0] no refreshing poll

==== httpshowpicons ====
{{Optional/en}}
NEW svn6648:05/01/2012

httpshowpicons = 0| 1
httpshowpicons = 1 # show picons in userlist
0 # default

If this parameter is enables, then a new column is added to the USERS tab which display the picons of the last watched channels by active users. The folder where the picons must be configured in the httppiconpath.

Possible format are:
IC_caid_srvid.tpl
IC_caid_provid_srvid.tpl
IC_servicename.tpl

added support for picons by channel name 
syntax is: 
take service-name from oscam.srvid, 
replace all upper-case letters with lower case, 
replace * with star, 
replace & with and, 
replace + with plus, 
remove everything but a-z and 0-9, 
if the result is name, the picon file will be IC_name.tpl 
for example: 
service-name "BBC-ONE +HD" 
picon file: "IC_bbconeplushd.tpl" 
if service-name ends with hd, and picon is not found, fallback to name without hd, example: 
picon file: "IC_bbconeplushd.tpl" 
-> not found, search for: 
picon file: "IC_bbconeplus.tpl" 

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

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

==== httphidetype ====
{{Optional/en}}
NEW svn8937:09/27/2013

httphidetype = type[type]...

type = letter which defines types to hide in web interface status page (see Typ column),
default: none. s = server, h = http, m = monitor, r = reader, p = proxy, x = cacheex, c = client

httphidetype = sh #hide server- and http-type columns
httphidetype = [blank] # hide none (default)

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

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

You can run script file from script.html (SCRIPTS item in main menu) 
If the script file contains the "echo" will be it displayed in a Web interface.

If the file can not run displays
[Error]: Script "name_of_script.sh" not executable!

If does not exist script displays
[Error]: Script "name_of_script.sh" not found!
(Works If you delete the script and refresh page)

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

CHANGE svn8733:06/27/2013

CHANGE svn8842:08/17/2013

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'''!

With '''::1''' OSCam decides to resolve 'localhost' to '''IPv6'''!

IP address|IP address range[,IP address|IP address range,[::1]]...

Example
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255 # Host and range 192.168.0 are allowed
= 127.0.0.1,192.168.0.0-192.168.255.255,::1 # Host and range 192.168.0 are allowed
resolving to IPv6

'''default values'''
127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255,::1

==== 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)

==== httppiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httppiconpath = path

path to picons, default [blank] none

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

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

==== httposcamlabel ====
{{Optional/en}}
NEW svn9463:01/28/2014

httposcamlabel = text

set individual label in web interface header, default: OSCam

 
 

=== [cache] ===
NEW since svn 8358:02/16/2013

{{OSCamConfCacheParameter}}

==== delay ====
{{optional/en}}

NEW svn8358:02/16/2013

Value to delay cached requests

Example:
delay = 300

Default:
delay = 0

==== max_time ====
{{Optional/en}}

NEW svn8358:02/16/2013

max_cache_time = seconds, default: 15

maximum time CWs resist in cache after 1st client request, the time must be 2 seconds higher than the parameter clienttimeout.

==== max_hit_time ====
{{Optional/en}}
NEW svn8910:09/10/2013

max_hit_time = in seconds

maximum time for cache exchange hits resists in cach for evaluating wait_time, default: 15

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

CHANGE svn 8077:01/06/2013

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

wait time for cache exchange (mode 2 & 3 only!)and Cardserverproxy before sending ECM to reader or proxy

Example:
0:50:250,0200@00009X:50:150:950,0500@000001:150:1602&ffdf:1200

==== cacheex_cw_check ====
{{Optional/en}}

cacheex_cw_check = caid[&mask][@provid][$servid]:mode:counter[,n]

* mode:
specify behaviour for counter parameter

0 = when wait_time expires, serve highest counter's cw got anyway, even if no counter reached.
1 = never serve cw (coming from cacheex) stored in cache if its counter not reaches counter. When wait_time expires, requests
will go to normal readers! Only when a cw reaches counter, it can be served to clients.

Default = 0

* counter:
set minimum cw counter to allow cw is used.

Default = 1 (use default behaviour: use cw with highest counter when cache is checked)

==== cwcycle_allowbadfromffb ====
{{Optional/en}}

NEW svn 8930:09/25/2013

cwcycle_allowbadfromffb = 0|1

1 = allow bad cycles from a fixed fallback reader. Default = 0

==== cacheexenablestats ====
{{Optional/en}}

NEW svn8358:02/16/2013

cacheexenablestats = 0|1

1 = enable statistics for cach exchange mode
0 = default

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

==== csp_port ====
{{required}}
NEW svn8358:02/16/2013

This is a UDP ('''not TCP''') listen port for incoming traffic from csp nodes

csp_port = port
= [blank] none (default)

==== csp_serverip ====
{{required}}
NEW svn 6358:2/16/2013

This is the local bind IP of csp_port (see above!)

csp_serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}
NEW svn 6358:2/16/2013

csp_allow_request = 0|1 default = 1

==== cwcycle_check_enable ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_check_enable = 0 disable (default)
= 1 enable

==== cwcycle_check_caid ====
{{Optional/en}}
NEW svn 8358:02/16/2013

[[Datei:WarningS.png|text-bottom]] '''Attention: not for all NDS SC's!'''

cwcycle_check_caid = CAID[,CAID]...

CAID enabled for CW cycle check, default: none

==== cwcycle_maxlist ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_maxlist = count

maximum CW cycle list entries, default = 500, maximum = 4000

==== cwcycle_keeptime ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_keeptime = minutes

minimum time a learned cycletime resists in memory, default = 0, maximum = 15

==== cwcycle_onbad ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_onbad = 0|1
0 = log bad CW cycle only
1 = drop bad CW cycle (default)

==== cwcycle_dropold ====
{{Optional/en}}
NEW svn 8358:02/16/2013

cwcycle_dropold = 0|1,
1 = drop old CW cycle,
0 = no drop(default)
 
==== cwcycle_sensitive ====
{{Optional/en}}
NEW svn 8509:03/07/2013

cwcycle_sensitive = 0|2|3|4

0 = disabled (default)
2 = 2 (or more) same bytes and drop new CW
3 = 3 (or more) same bytes and drop new CW
4 = 4 (or more) same bytes and drop new CW

 
==== cwcycle_usecwcfromce ====
{{Optional/en}}
NEW svn 9038:11/18/2013

cwcycle_usecwcfromce = 0|1

1 = use CW Info from cache exchange
0 = default
 

==== wait_until_ctimeout ====
{{Optional/en}}
NEW svn 9486:02/03/2014

wait_until_ctimeout = 0|1

answer when cache exchange timeount expires, if no normal readers are vavailable for sending ECM's::

0 = immediatly send '''not found''' to client (default)
1 = wait for cache exchange answer until client timeout expires

 
 

 

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

OBSOLETE svn8358:02/16/2013 look at '''[cache]'''!

{{OSCamConfcspParameter}}

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

UDP listen port for incoming traffic from csp nodes

port = port
= [blank] none (default)

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

Local bind IP of the above udp port

serverip = IP
= [blank] none (default)

==== csp_ecm_filter ====
{{Optional/en}}

csp_ecm_filter = [caid][&mask][@provid][$servid]

==== csp_allow_request ====
{{Optional/en}}

csp_allow_request = 0|1 default = 1

=== 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)

=== cs357x (UDP) ===
Section required only if 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:: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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: [[Streamboard-Thread:27459|Streamboard-Thread]]

=== 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

 
 
=== '''scam''' ===

NEW svn9878:09/29/2014

{{OSCamConfSCamParameter}}

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

port = port

UDP port for scam server, default = 0

==== 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
 
 

=== 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}}

CHANGE svn8607:04/10/2013

reshare level for CCcam clients:
-1 = no resharing
0 = resharing for direct peer only
1 = 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 and next level

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, values <= 10 are invalid and will be set to 30
= [blank] 240 (default)

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

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

==== recv_timeout ====
{{Optional/en}}
NEW svn7672:10/09/2012

recv_timeout = milli-seconds

set network timeout for receiving data
default = 2000

==== 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 ===
NEW svn8350:02/15/2013
{{OScamConfGboxParameter}}
 
 
'''Minimal working configuration example:'''

Let's say the gbox runs on host 192.168.1.101 and OSCam is on 192.168.1.123. In file '''cwshare.cfg''' on gbox side we have, for example, the following lines::
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
If oscam_gbox should connect to the original GBOX above, then you should configure OSCam as follows:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 

===== my_password =====
{{required}}
NEW svn9163:12/31/2013
'''moved from oscam.server'''

CHANGE svn9494:02/04/2014
 

password = 4 hex bytes, 8 chara

my password

example
98AF3E25

 

==== proxy_card ====
{{Optional/en}}
NEU svn9721:05/15/2014

proxy_Card = <CAID><provid>[,<CAID><provid>]...

proxy reader SmartCard(s) to be reshared with gbox network, def. = 0, default = none

 

==== ccc_reshare ====
{{Optional/en}}
NEW svn9722:05/15/2014

ccc_reshare = 0|1

1 = enabled cccam reshare into gbox network, default = 0

 

==== hostname ====
{{required}}
CHANGE svn9494:02/04/2014

gbox_hostname = my IP or hostname

 

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

port[,port]... own gbox port

 

==== my_vers ====
{{Optional/en}}
NEW svn9645:04/09/2014

my_vers = version

set gbox version in hexadecimal low byte

default = 25

 

==== my_cpu_api ====
{{Optional/en}}
NEW svn9712:05/11/2014

my-cpu_api = byte

set gbox CPU and API byte in hexadecimal, default = 40
default = 40

 

==== gbox_reconnect ====
{{Optional/en}}

gbox_reconnect = time

send message to peers in seconds, default:300

 

==== gsms_disable ====
{{Optional/en}}
NEW svn9714:05/11/2014

gsms_disable = 0|1

1 disable gbox short message service (GSMS), default = 0

 
 
==== tmp_dir ====
{{Optional/en}}
NEW svn9761:06/05/2014

tmp_dir = path

tempory directory for gbox

default = /tmp/.oscam
 
 

=== 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:
au = 0 # disable AU (default)
au = 1 # enable AU

==== 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
pmt_mode = 6 # use PMT server mode NEU - NEW - NOUVEAU - NUOVO svn8680:05/06/2013

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

==== listen_port ====
{{Optional/en}}

NEW svn9574:03/20/2014

listen_port = 0|1

TCP/IP port for SAT IP clients, filtering has to be done on client site

0 = disabled (default)

==== 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

==== delayer ====
{{Optional/en}}
NEW svn6808:05/14/2012

delayer = milli-seconds

minimum time to write CW

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

OBSOLETE svn9072:12/08/2013

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

==== decodeforever ====
{{Optional/en}}
NEW svn7653:10/08/2012

OBSOLETE svn8683:06/06/2013

decodeforever = 0|1

1 = trying to decode on all CAIDs
0 = default

==== ecminfo_type ====
{{Optional/en}}
NEW svn10722:06/13/15

Define the type of ecm.info file to create, ecminfo_type = 0|1|2|3|4|5

0 = default oscam syntax
1 = default oscam syntax with ecmtime in ms instead of s
2 = wicardd
3 = mgcamd
4 = cccam
5 = camd3

==== read_sdt ====
{{Optional/en}}
NEW svn10766:06/15/15

If it is not yet available, this option automatically add entries in your oscam.srvid2 (or oscam.srvid) and in your oscam.provid files. You need to stay '''more than 30 seconds''' on a channel for the auto-detect to start. So both channel name and provider name are retrieved. If entries already exist they are not changed nor updated, so you keep full control on the content of both files, only missing entries are added.

read_sdt = 0|1|2

0 = disabled (default)
1 = on, do not save FTA channels
2 = on, save FTA channels

==== write_sdt_prov ====
{{Optional/en}}
NEW svn10841:06/27/15

First enable the read_sdt parameter then you can specify if the provider name is saved or not into the oscam.srvid2 or oscam.srvid file. This is not mandatory since the provider name is now retrieved automatically from the oscam.provid file.

write_sdt_prov = 0|1

0 = off, do not write provider name into oscam.srvid/2 (default)
1 = on, write provider name into oscam.srvid/2

=== 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)
 

==== acosc_enabled ====
{{Optional/en}}
NEW svn9761:06/05/14
 
acosc_enabled = 0|1
1 = enable anticascading oder SIDs count
0 = default
 
==== acosc_max_active_sids ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_max_active_sids = count

maximum activ SIDs with anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user

 

==== acosc_zap_limit ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_zap_limit = count

zap limit for anticascading over SIDs count

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_penalty ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty = 0|1|2|3

level of penalty with anticascading over SIDs count:

0 = only logging (default)
1 = send fake DWs
2 = ban user temporary
3 = send real DWs with delay
can be overwritten per user in oscam.user
 

==== acosc_penalty_duration ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_penalty_duration = seconds

penalty duration for anticascading over SIDs count:

0 = unlimited (default)
can be overwritten per user in oscam.user
 

==== acosc_delay ====
{{Optional/en}}
NEW svn9761:06/05/14

acosc_delay = milliseconds

delay for anticascading over SIDs count

0 = unlimites (default)
can be overwritten per user in oscam.user
 

{{OSCamTranslatedLinks}}

OSCam/fr/Config/oscam.server

2016-12-18T10:58:49Z

Pr2: /* ident */ mentionne qu'il s'applique uniquement sur les EMMs et donc pas pour les ECMs

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

== oscam.server ==
Ce fichier de configuration des lecteurs de carte (reader: ce terme, qui désigne le lecteur, sera dorénavant utilisé dans la suite du document) contient les paramètres de configuration des readers/lecteurs nécessaires à oscam pour pouvoir y accéder. Les sections du fichier oscam.server sont récurrentes (plusieurs readers/lecteur peuvent être repris). La section doit contenir a minima un reader/lecteur!

Des exemples de configuration pour des cartes spécifiques peuvent être trouvés dans [[OSCam/fr/examples/Reader|exemples de configurations]]

=== Reader ===
''Plusieurs sections [reader] peuvent être créées. Chaque section correspond à un reader/lecteur bien déterminé .
Exemple: phoenix, easymouse, sc8in1 etc

{{OSCamServerParameter}}

==== label ====
{{Obligatoire}}

Détermine le nom du reader (lecteur). Aussi bien pour un lecteur local que pour un lecteur distant.

Exemple
label = cardreader-canal

==== enable ====
{{Pasindispensable}}

Détermine si le reader/lecteur est actif (=1) ou pas (=0)
0 = Désactivé
1 = Activé (paramètre par défaut)

==== description ====
{{Pasindispensable}}

description =

Description du reader (lecteur), par défaut = rien

==== protocol ====
{{Obligatoire}}

Protocole de communication du reader (lecteur)
protocol = mouse (Lecteur de carte local)
= internal (Tous les Lecteurs de carte du type "Device=/dev/sciX", et les lcteurs de carte des Coolstreams)
= camd35|cs357x (Cascading - camd 3.5 serveur distant compatible - '''udp''')
= mp35
= smargo
= smartreader
= serial
= cs378x (camd 3.5 serveur distant compatible - '''tcp''')
= gbox
= newcamd|newcamd525
= newcamd524
= cccam
= radegast
= pcsc
= constcw

==== device ====
{{ Obligatoire}}

MODIFICATIONS svn8057+8059:01/04/2013

MODIFICATIONS svn8096:01/13/2013

MODIFICATIONS svn8911:09/10/2013

Détermine le dispositif (lecteur de carte local ou serveur distant) permettant l'accès aux droits en local ou à distance pour la section [reader].
device = [<readertype>;]serial:serialnum|bus:device|<device|device:slot>|<ip|hostname>,<port>[,<lport>]|pcsc|<0|1>>|constantcw

readertype:
SR: Smartreader+ (par défaut)
SRv2: Smartreader V2
Infinity: Infinity USB
TripleP1: Smargo Triple Reader port 1
TripleP2: Smargo Triple Reader port 2
TripleP3: Smargo Triple Reader port 3
bus:device: Nom du Bus e Device (par ex.. monlecteur)
serialnum: N° de série du lecteur de type Smartreader (N° de lsusb 'Bus' et 'Device' sont obtenus au démarrage!)
device: Nom du dispositif
device:slot: Nom de dispositif de lecture de la carte No de Slot '''sc8in1'''
ip|hostname: Adresse IP ou nom de l'hôte (hostname)
port: Numéro du TCP/IP port (exemple : 5000)
lport: Remapping du port local
PCSC: N° du Lecteur PCSC (démarre à 0)
0|1: '''Seulement pour le Coolstream hd1''' (sélectionnez 0 ou 1)
constantcw: Chemin d'accès absolu indiquant où se trouve le fichier constant.cw au niveau local et/ou serveur (exemple : /usr/keys/constant.cw)

Format des CW-Files:
'''Standard-Format'''
CAID:Provider ID:Service ID:PMT ID:ECM PID::key (16 Bytes seperated by spaces)
exemple:
1234:123456:1234:2345:3456::00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

'''Extended OSCam-Format'''
CAID:Provider ID:Service ID:PMT ID:ECM PID:Video PID:key (16 Bytes seperated by spaces)
exemple:
1234:123456:1234:2345:3456:7890:00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

Exemples de configuration pour le paramètre <device>
device = /dev/ttyS0 # (Lecteur sur COM1 (Linux i386 et Windows))
device = /dev/tts/1 # (Lecteur sur COM2 (Linux dbox2 avec multicam))
device = /dev/ttyUSB0 # (Lecteur sur USB (Linux i386))

'''Note''': Le N° du Device est situé une unité sous le N° des Ports COM-! Ainsi ttyS0 = COM1, tts/1 = COM2. Il se peut que sur les nouveaux pc les ports com ne soient plus disponibles, dans ce cas USB2 sera utilisé. Il est préférable de vérifier dans le gestionnaire de périphériques le N° du port utilisé par le Lecteur et lui soustraire 1

==== detect ====
{{Version}}

Détection du statut de la '''carte insérée'''.
Detect = CD (Carrier Detect) - par défaut -
Detect = DSR (Data Set Ready)
Detect = CTS (Clear To Send)
Detect = RING (Ring Indicator)
Detect = NONE (La reconnaissance de la carte est désactivée, néanmoins le fait qu’une carte est insérée sera signalé)
Detect = gpio1 ... gpio7 (nouveau pour mipsel-uclibc)

'''* • Action inverse = "!" à inclure devant (par ex.. "Detect=!CTS")'''

==== cardmhz ====
{{Version}}
MODIFICATIONS svn7046:06/12/12

Fréquence '''standard''' de la carte par multiple de 10.KHz. Pour une carte irdeto la fréquence est de 600 KHz. Voir [[OSCam/fr/examples/Overclocking|Overclocking]]!

Exemple:
cardmhz = 600 # 600 pour une carte irdeto
= # si rien n’est indiqué, c’est la valeur par défaut de 357 est prise

auto clock speed for '''Dreambox''' = -1. Pour plus d'informations sur les différentes(Dream)Boxes cf. le lien suivant : [http://www.streamboard.tv/oscam/wiki/ReaderClocks here].

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== mhz ====
{{Pasindispensable}}
MODIFICATIONS svn9099:12/13/2013

Indépendamment du paramètre '''cardmhz''' et pour autant que cela soit possible, la fréquence standard de la carte peut être changée par incréments de 10KHz (comme mentionné ci-dessus) on parle alors de '''Overclocking'''. On peut ainsi overclocké une Carte s02- (Standard 6 MHz) à 10 MHz. Voir [[OSCam/fr/examples/Overclocking|Overclocking]]

Cela se passe de cette façon:
cardmhz = 600 # ( 6000 KHz = 6 MHz)
mhz = 1000 # (10000 KHz = 10 MHz)

'''La valeur par défaut est 357'''

Hier eine ausführlichere Beschreibung von '''stefansat''' aus der Distri-Doku:

'''EXTERNE READER'''

Wenn die Frequenz in '''mhz''' größer ist als in '''cardmhz''', dann befindest Du dich im Modus [[OSCam/de/examples/Overclocking|Overclocking]].

Smargo-Reader und interne Reader von Dreambox werden durch '''atr''' automatisch eingestellt, wenn in '''autospeed''' (siehe nächsten Parameter) '''= 1''' gesetzt ist.

'''INTERNE READER'''

Setze die Reader-Frequenz in 10 KHz-Schritten. Wenn Du eine '''cardmhz''' kleiner 2000 benutzt, schaltet OSCam auf PLL-Clocking. Interne Reader von Boxen der Firma Dream Multimedia GmbH können damit wesentlich genauer eingestellt werden. Die benutzte Frequenz in '''mhz''' sollte die höchste Frequenz des Quarzes im internen Reader darstellen. OScam wird den besten PLL-Divider errechnen, der der in '''cardmhz''' gewünschten User-Card-Geschwindigkeit am nächsten kommt.

Für Modelle mit '''PPC-CPU''' benutze '''mhz = 3150'''. Für Modelle mit '''MIPS-CPU''' benutze '''cardmhz = 2700'''. Ausnamhe ist die '''DM7025''', hier sollte '''cardmhz = 8300''' benutzt werden.

Beispiel
Du hast eine DREAM 800 HD PVR. Das ist eine MIPS. Daher solltest Du cardmhz auf 2700 setzen. Du verwendest eine NAGRA-Card,
die sollte auf 5 MHz laufen. Um die Karte normal zu lesen, benutzt Du daher cardmhz = 2700 und mhz = 500.
Wenn Du Overclocking anwenden willst, setzte cardmhz = 2700 und mhz = auf 900. Nun wird Deine Karte mit 9 Mhz zu laufen beginnen.
Es ist besser, das am Anfang zu beobachten, denn eine overclocked Karte kann heiß laufen und plötzlich crashen!

Beachte, dass die meisten internen Reader von Nicht-Dreamboxen die Karten automatisch lesen und alle vom User gesetzten Werte vollständig ignorieren. Trotzdem sollten unter cardmhz und mhz immer Werte eingetragen werden, weil sie die interne Kalkulation der korrekten timings von OSCam unterstützen. Wenn die Werte in cardmhz und mhz korrekt gesetzt werden, arbeitet OSCam besser mit der automatischen clockspeed des internen Cardreaders zusammen. Daraus resultieren bessere ECM-Antwortzeiten oder eine größere Stabilität.

Aber bitte keine Wunder erwarten! Nur Overclocking kann ECM-Antwortzeiten reduzieren. Schlechte Einstellungen können sie nur verzögern oder instabil machen.

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/CardsList|List of default and overclocking card frequencies]]'''

==== autospeed ====
{{Pasindispensable}}
NOUVEAU svn9064:12/01/2013

autospeed = 0|1

1 = Détection automatique de la vitesse du lecteur par l'ATR pour les lecteurs interne dreambox, smargo et smartreader (défaut).
0 = Désactivé : utiliser les valeurs Mhz pour définir la vitesse.

==== deprecated ====
{{Pasindispensable}}
{{AVenir}}
D'abord, la carte sera initialisée en mode normal. Si elle échoue, la carte sera automatiquement reprise en mode déprécié, de sorte que la vitesse de la carte ne sera pas changée et la communication restera sur la vitesse normale de l'ATR de 9600 baud.
deprecated = 1 mode déprécié activé
= 0 par défaut

==== mode ====
{{Version}}

'''Valable uniquement pour un lecteur de type AZBox'''

Rend possible l’initialisation de la carte sur un Lecteur d'AZBox
mode = 1 # active le mode initialisation pour un Lecteur d’ AzBox
= 0 # désactivé, valeur par défaut

==== device_out_endpoint ====
{{Version}}

MODIFICATIONS svn8013:12/29/2012

Détermine l’adresse de sortie des Chips FTDI, les valeurs possible sont: 0x81 ou 0x82
en fonction de ceci:
device_out_endpoint = 0x81 # Smargo Triple Reader port 1
= 0x82 # Smartreader+ (default)
= 0x83 # Smargo Triple Reader port 2
= 0x85 # Smargo Triple Reader port 3

==== smargopatch ====
{{Pasindispensable}}
NOUVEAU svn6402:02/16/2012

smargopatch = 0|1

schaltet den workaround für smargoreader+ und reader ein, bis der native mode funktioniert, default = 0

==== sc8in1_dtrrts_patch ====
{{Pasindispensable}}
NOUVEAU svn6402:02/16/2012

sc8in1_dtrrts_patch = 0|1

1 = active le correctif du bug kernel DTR/RTS pour les lecteur SC8in1/MCR, par défaut = 0

==== cool_timeout_init ====
{{Pasindispensable}}
NOUVEAU svn6286:01/23/2012

cool_timeout_init = timeout en mille-secondes

Timeout pendant l'initialisation du lecteur interne du coolstream '''pour AZBox!''', par défaut = 0

==== cool_timeout_after_init ====
{{Pasindispensable}}
NOUVEAU svn6253:01/17/2012

[[Datei:WarningS.png|text-bottom]] '''Attention: seulement pour Coolstream!'''

cool_timeout_after_init = timeout en mille-secondes

Timeout après initialisation du SC lecteur interne du coolstream, par défaut = 0

==== ins2e06 ====
{{Pasindispensable}}
NOUVEAU svn9568:03/16/2014

add check control for pin payload (4 hex bytes) for NDS Videoguard 2 SCs
ins2e06 = Payload
= # none [blank] (default)
[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only

http://www.streamboard.tv/oscam/changeset/9568

==== ins7e ====
{{Pasindispensable}}
NOUVEAU svn5959:09/22/2011

ins7e = 26 (0x1A) octets (option pendant le démarrage des cartes NDS2).

Si le paramètre est configuré, il doit contenir 26 octets.
S'il n'est pas configuré ou vide, l'INS7E ne sera pas envoyée à la carte lors du démarrage.

==== ins7e11 ====
{{Pasindispensable}}
NOUVEAU svn6064:12/06/2011

ins7e11 = TA1 (1 octet; le 3ème octet de l'ATR)
= 11 # 0001 FI + 0001 DI (1 x)
= 13 # 0001 FI + 0011 DI (4 x)
= 14 # 0001 FI + 0100 DI (8 x)
= 15 # 0001 FI + 0101 DI (16 x)

Mode rapide pour les cartes NDS2 v13 et G02/G09 (lecteur physique uniquement).

==== fix07 ====
NOUVEAU svn9884:09/30/2014
{{Pasindispensable}}
enable 0x07 fix for NDS Videoguard 2 SCs
fix07 = 1 # enabled (default)
= 0 # disabled
[[Datei:WarningS.png|text-bottom]] '''Attention:''' valid for physical readers only

==== force_irdeto ====
{{Pasindispensable}}

Force le mode Irdeto, même si une clé RSA est présente pour le tunnel Irdeto vers les cartes Nagravision
force_irdeto = 1 # activé
= 0 # désactivé, valeur par défaut

==== nagra_read ====
{{Pasindispensable}}

Lit les registres/'records' "Nagravision. '''Uniquement pour les cartes NCMED'''
nagra_read = 0 # désactivé, valeur par défaut
= 1 # lit les Records dont les droits sont dépassés
= 2 # lit seulement les Records dont les droits sont valables

==== rsakey ====
{{Pasindispensable}}
MODIFICATIONS svn7046:06/12/12

Clef RSA pour les cartes Nagravision /Tiger SCs / CAM-Key pour les cartes Irdeto, cartes Conax. Par défaut, aucune clef indiquée.
rsakey =

==== deskey ====
{{Pasindispensable}}
NOUVEAU svn10894:07/15/15

Clef 3DES de 16 octets pour les cartes Viaccess. Par défaut, aucune clef indiquée. 
En Viaccess, ce paramètre va de pair avec boxkey.
deskey =

==== fix9993 ====
{{Pasindispensable}}

fix9993 = 0|1

Corrige l'erreur 9993 sur CAID 0919 SC's

fix9993 = 1 # activé
= 0 # désactivé (par défaut)

==== readtiers ====
{{Pasindispensable}}
NOUVEAU svn10376:02/02/15

readtiers = 0|1|2

method to get tiers of NDS Videoguard SCs

readtiers = 0 # disabled (default)
readtiers = 1 # ins70 (new) method
readtiers = 2 # ins76 (old) method

==== boxkey ====
{{Pasindispensable}}

Box Key pour les cartes Nagravision / CAM-Key pour les cartes Irdeto / Session key pour les cartes Seca / ChipID ou CamID également désignée dans le menu récepteur comme Identifiant du récepteur ou Identifiant décodeur. En Viaccess, l'identifiant fait 4 octets (obtenu après envoi de l'instruction ECM postcam CA 28 00 00 04). Il est souvent précédé de 2 octets == 00 et affiché comme suit : 0 x 00 AB CD EF, et il va de pair avec le paramètre deskey.

==== pincode ====
{{Pasindispensable}}

Code PIN pour les cartes dont les contrôles d'accès sont '''Conax, Cryptoworks, Seca, Nagravision ou Viaccess'''
pincode = code pin
= # [rien] valeur par défaut

Valeurs d'origine des cartes

{| border="1"
| '''Carte'''
|| '''Pin Code par défaut'''
|-
| BIS.tv || 8080
|-
| SSR-SRG/TSR|| 0000
|-
| Canal Seca (018)|| 0000
|-
| Canal Viaccess (039)|| 0000

|}

==== boxid ====
{{Pasindispensable}}

ID du '''récepteur NDS Vidéoguard'''
boxid = ID du récepteur NDS Vidéoguard

==== ndsversion ====
{{Pasindispensable}}

Détermine la version du '''NDS Videoguard'''
0 = # détection auto, valeur par défaut
1 = # NDS Videoguard 1
12 = # NDS Videoguard 1+
2 = # NDS Videoguard 2

==== aeskeys ====
{{Pasindispensable}}

Clés AES multiples de 16 octets(bytes) pour cartes '''Viaccess''' (l'utilisation du pro/pre encryption est spécifié via la nano 0xD2 nano dans l'ECM. Cette nano 0xD2 est visible dans le log precam ECM envoyé par le diffuseur/opérateur)
CAID #ident:AES key #0 CAID #0[,AES key #1 CAID #0],...[;CAID #1@ident::AES key #0 CAID #1[,AES key #1 CAID #1],...]...

Spécial pour clés AES:
00 = ne renvoit pas de CW , aucune clé AES n’est spécifiée
FF = renvoit des CW reçus de S, aucune clé AES n’est spécifiée

Exemple
aeskeys = 0500@012345:000102030405060708090a0b0c0d0e0f;0500@54321:0,0,0f0e0d0c0b0a090807060504030201
aeskeys = 0500@012345:clé0,clé1,clé2,clé3,clé4,clé5,...;0500@543210:clé0,clé1,clé2,clé3,clé4,clé5,....
si une clé n'est pas connue mettre 0 à la place exemple: aeskeys = 0500@012345:clé0,clé1,0,0,clé4,clé5,...

==== showcls ====
OBSOLÈTE svn6624:04/23/2012
{{Pasindispensable}}

Nombre de classes à montrer pour les '''Cartes Viaccess'''
schowcls = Quantité
= 0 # aucune, valeur par défaut

==== key ====
{{Version}}

Clé de cryptage DES pour un reader/lecteur Newcamd distant
key = clé DES

==== user ====
{{Pasindispensable}}

Nom d'utilisateur pour le reader distant. Remplace le nom de l'utilisateur de "account". Premier arrivé, premier servi. Voir '''account'''

Exemple
user= # xyxyx

==== password ====
{{Pasindispensable}}

Mot de passe pour le reader/lecteur distant. Remplace le mot de passe de "account". Premier arrivé, premier servi. Voir '''account'''

Exemple
password = # xyxyx

==== mg-encrypted ====
{{Pasindispensable}}

VERALTET - OBSOLETE - OBSOLÈTE - ANTIQUATO

Nouveau paramètre pour le reader gbox dans oscam.server à partir de la svn-4804, puis étendu à partir de la svn-4806.

svn-4804: support pour la ligne gbox cryptée de mgcamd (le nouveau paramètre "mg-encrypted" prend la place des paramètres "device" et "password")

svn-4806: le paramètre "mg-encrypted" étendu pour permettre de spécifier une adresse MAC.

Usage:

mg-encrypted = <encrypted line>,<mac address>

ou

mg-encrypted = <encrypted line> (c'est l'adresse MAC de eth0 de la box locale qui sera utilsée)

Exemple du reade0/lecteur de type gbox dans oscam.server:

[reader]
label = mygboxreader
protocol = gbox
mg-encrypted = D: { hostname { 1234 5678 { ABCD1234 { 9 9 }}}}
group = 11
caid = 1100

==== services ====
{{Pasindispensable}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Si dans oscam.conf [global] est activé dans charge entre lb_mode, alors il y a peut-être pas les entrées!

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Le nombre de services qui seront considérés comme lecteur basé, est limitée à 64 ou 64 fois [[service-name][CAID][provid][srvid]]!

Quels services peuvent être traités par le reader/lecteur. Cela nécessite la présence d'un fichier oscam.services. La logique ici est la suivante (dans cet ordre):
* Si le champ est vide (ou invalide), la requête est autorisée.
* Quand un service négatif (çàd précédé d'un "!") Est applicable, la demande est rejetée.
* Si un service positif est applicable ou il existe aucun service positif, la demande est autorisée.
* Si aucun des points précédents, la demande est rejetée.
Cela signifie que les services négatifs ne sont nécessaires que dans des cas particuliers.
A savoir, si vous avez un service positif mais que l'on veut exclure certains srvid.
Ce n'est pas recommandé, car des erreurs de configuration apparaissent rapidement.
Au lieu de cela, il vaut mieux créer un service supplémentaire contenant tous les srvid appropriés.

Alloue au reader/lecteur ou exclu du reader/lecteur un groupe de services
services = [!]services[,[!]<services>]...
= Tous les services sont autorisés (par défaut)

Exemple :
services = Csat,C+,!Bis
# Csat et C+ sont alloués, Bis est exclu (remarquez le ! devant Bis)

==== caid ====
{{Pasindispensable}}

MODIFICATION svn 5097:04/27/2011

Définit et permet de lier les CAIDs pour le reader/lecteur

Exemple:
caid = 0100
caid = 0200&ffee:0300
caid = 0400&ff00:0500,0600
caid = 0702,0722
caid = 0702&ffdf (raccourci pour l'exemple au-dessus)
par défaut: tous les CAIDs avec le masque FFFF
==== ident ====
{{Pasindispensable}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Si in oscam.conf [global] est activé dans charge entre lb_mode, alors il y a peut-être pas les entrées! 
Ce paramètre s'applique uniquement pour les EMMs et donc ne s'applique pas sur le ECMs. Il n'est donc pas possible de forcer l'envoi d'ECM vers la carte via ce paramètre. 

Définit le CAID et l’ Ident '''SC specific''' pour un reader/lecteur donné
ident 0 <CAID>:<ident>[,ident]...[;<CAID>:<ident>[,ident]...]...

Exemple
ident = # 0100:123456,234567;0200:345678,456789
= # [rien] aucun CAID et ident n’est définit (valeur par défaut)

==== class ====
{{Pasindispensable}}

Définit en '''hexadécimal''' la classe pour le reader/lecteur pour lequel vous souhaitez (ou pas) ouvrir les droits permettant la visualisation
class = 01,02,!1b,!2b # 01 et 02 oui, 1b et 2b non
= # [rien] aucune définition de classe (valeur par défaut) => ouvre tous les programmes ayant les classes contenues dans la carte d'abonné.

==== localcards ====
{{Pasindispensable}}

Utilise ce lecteur (pour le CAID défini) comme un lecteur "local" (et non distant) dans la section LB/reader.
Il sera alors traité comme un lecteur local pour le LB et le paramètre preferlocalcards. De cette manière, nous pouvons considérer un lecteur distant comme un lecteur local, comme si nous avions un lecteur de carte local.

localcards = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]....

==== chid ====
{{Pasindispensable}}

Définit le '''ChID Irdeto''' pour le Reader/Lecteur

Exemple
chid = 0100:12
chid = 0100:12;0604:0000BA,000101,00010E,000141
= # [rien] valeur par défaut

==== group ====
{{Obligatoire}}
MODIFICATIONS svn6103:12/21/2011

Chaque reader/lecteur doit appartenir à un ou plusieurs groupes. On détermine ainsi quel client a accès à quel reader/lecteur. Les valeurs vont de 1-64
group = 1....64[,1....64]....

'''Comme l'entrée est obligatoire, il doit n'y avoir aucune [blanc] par défaut !'''

Exemple
Group = 1 # (un seul groupe => 1)
Group = 1,4,5 # (plusieurs groupes => 1, 4 et 5)

==== audisabled ====
{{Pasindispensable}}

Exclu le reader/lecteur de l’ AU (mise à jour automatique)
audisabled = 1 # activé (la carte ne sera pas mise à jour)
= 0 # désactivé: valeur par défaut (la mise à jour de la carte peut se faire)

==== auprovid ====
{{Pasindispensable}}

Donne ici l’ID du provider/provid pour lequel la mise à jour automatique doit être effectuée via ce reader/lecteur.

Exemple
auprovid = # 123456
= # [rien] valeur par défaut, rien n'est donné

==== disableserverfilter ====
{{Pasindispensable}}

Ignore les CAID et Ident des readers/lecteurs de clients défectueux .
disableserverfilter = 1 # activé (ignore les caid et ident)
= 0 # valeur par défaut : désactivé (n'ignore rien)

==== inactivitytimeout ====
{{Version}}

inactivitytimeout = # en secondes
= -1 # reconnexion en cas de perte du réseau pour Readers '''Newcamd et Radegast''', même en mode attente.
= 0 # par défaut rien n'est donné

==== reconnecttimeout ====
{{Pasindispensable}}

MODIFICATIONS svn7244:08/07/2012

Délai en secondes avant le renouvellement d'une connexion avec un lecteur/reader distant qui ne répond plus.

Exemple
reconnecttimeout = 20 # Après 20 secondes sans activité, la connexion est rétablie
= # [rien] par défaut, rien n'est mentionné

==== connectoninit ====
{{Pasindispensable}}
NOUVEAU svn8235:01/29/2013

= 0|1

''Permet d'établir la connexion Newcamd, même s'il n'y a pas de demande.''

connectoninit = 1 # connexion établie à l'init
connectoninit = 0 # connexion non établie à l'init (valeur par défaut)

==== keepalive ====
{{Pasindispensable}}
NOUVEAU svn9810:07/22/2014

keepalive = 0|1

1 = ermöglicht es einem cs378x TCP socket, ständig verbunden zu sein
0 = Immer eingeschaltet bei einem cacheex reader type (default)

==== fallback ====
{{Pasindispensable}}

[[Datei:WarningS.png|text-bottom]] '''Attention:''' Ne s'applique pas si l'équilibreur de charge (loadbalancer) est activé!

Définit le Reader comme Fallback Reader. Standard et Fallback-Reader doivent appartenir au même groupe. Voir '''group'''
fallback = 1 # activé (ce reader est le fallback reader)
= 0 # valeur par défaut : désactivé

==== fallback_percaid ====
{{Pasindispensable}}
NOUVEAU svn8896:09/04/2013

fallback_percaid = <CAID>[:<ident>[,ident]]...[;<CAID>[:<ident>[,ident]]...]...

use reader as fallback for defined CAIDs only, two digit wildcards CAIDs are possible, fallback_percaid overrules fallback. Def.=none

example:
fallback_percaid = 1234:234567;10:345678

==== emmcache ====
{{Pasindispensable}}

Definit les Caches d'EMM pour le Reader. Actuellement, seulement pour les readers locaux. Concerne la fonction AU. On détermine sous quelles conditions les (EMM) du Provider seront écrits

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
Sans ce paramètre, no EMM sont présentés dans le log!

Format:
'''''emmcache = <usecache>,<rewrite>,<logging>,<stb-emm>'''''

* <usecache> 0 = # cache désactivé (valeur par défaut)
* <usecache> 1 = # cache activé, et l'écrire à la fin dans un fichier
* <usecache> 2 = # cache activé, mais ne pas l'écrire à la fin dans un fichier

* <rewrite> n = # détermine combien de fois des (EMM) identiques sont réécrits. Uniquement si la valeur <usecache> = 1 ou 2

* <logging> 0 = # Entrée dans le fichier log désactivée (valeur par défaut)
* <logging> 1 = # Log uniquement les EMM erronés
* <logging> 2 = # Log les EMM écrits
* <logging> 4 = # Log les EMM rejetés
* <logging> 8 = # Log les EMM bloqués
* <logging> 16 = # Log les AU blockés

La valeur de logging est le résultat de la somme des options que vous voulez activer, donc 16+8+4+2+1 = 31 pour tout activer.

* <stb-emm> 0 = # EMM pour le STB sont ignorés (par défaut)
* <stb-emm> 1 = # EMM pour le STB sont envoyés vers ce reader (utilisation très spécifique)

Exemple
emmcache = 1,3,10,0 # Cache activé, Les EMM sont réécrits 3 X, les écrits (2) et les bloqués (8) = 10 sont logués, les emms pour le STB ne sont pas envoyés
emmcache = 1,2,6,0 # Cache activé, Les EMM sont réécrits 2 X, les écrits (2) et les rejetés (4) = 6 sont logués, les emms pour le STB ne sont pas envoyés

 

==== emmreassembly ====
{{Pasindispensable}}

NOUVEAU svn8493:03/06/2013

OBSOLÈTE svn8591:04/01/2013 parameter now in oscam.user!

emmreassembly = 0|1

1 = enable EMM reassembly, default
0 = disable EMM reassembly

Paramètre applicable aux readers/lecteurs Viaccess et Cryptoworks si le client que vous utilisez pour l'envoi d'EMMs regroupe les EMMs plutôt que de les envoyer simplement à OSCam pour traitement.

 

==== cacheex ====
{{Pasindispensable}}
NOUVEAU svn6044:11/27/2011

C'est pour échanger le cache d'OSCam.

1 = échange du cache activé pull mode
2 = échange du cache activé push mode
3 = échange du cache activé reversepush mode
0 = par défaut

- Uniquement valable entre 2 ou plusieurs OSCam;
- Devraient marcher avec tous les protocoles supportant le multiple ecm ex: camd35 ou cccam.

===== cacheex-modes =====
===== cacheex = 1 - cachepull =====
Situation:

OSCam A reader1 est réglé sur cacheex = 1

OSCam B account1 est réglé sur cacheex = 1

OSCam A reçoit une demande ECM, reader1 envoie cette demande à OSCam B,

OSCam B vérifie son cache:
* rien dans le cache n'est trouvé: OSCam B envoie: NOK
* quelque chose dans le cache est trouvé; OSCam B envoie: OK+CW
* quand rien dans le cache n'est trouvé, il est noté une demande en attente: ''cacheexwaittime'' dans oscam.conf [global] est attendu et puis re-examinée. OSCam B ne demande plus de nouvelles EMMs.

CW-flow = B ---> A

===== cacheex = 2 - cachepush =====
Pour les protocoles camd 3.5x et CCcam

Situation:

OSCam A reader1 est réglé sur cacheex = 2

OSCam B account1 est réglé sur cacheex = 2

Quand Oscam B reçoit un CW, il est poussé sur Oscam A. Le reader a des fonctions normales et peut demander des ECM.
* Problème: OSCAM ne peut pas pousser les CW sur Oscam A, si il est connecté à Oscam A
* Fonctionnalité ou problème?: OSCam A peut demander des ECM à OSCam B

CW-flow = B ---> A

===== cacheex = 3 - reversecachepush =====
Pour les protocoles camd 3.5x et CCcam

Situation:

OSCam A reader 1 est réglé sur cacheex = 3

Quand OSCam A reçoit un CW, il est poussé à Oscam B. OSCam A ne demande plus de nouvelle ECM

CW-flow = A ---> B

==== cacheex_maxhop ====
{{Pasindispensable}}
NOUVEAU svn6691:05/07/2012

cacheex_maxhop = n

Par défaut = 10

==== logport ====
{{Pasindispensable}}

Port de connexion pour un Reader Camd 3.x-. UDP doit être activé. Fonctionne, seulement si l’anticascading n’est pas activé dans Camd 3.x
logport = # N° du port
= # par défaut, aucun port n’est activé)

==== ecmwhitelist ====
{{Pasindispensable}}

ecmwhitelist = [CAID[@provid]:]length[,length]...[;[CAID[@provid]:]length[,length]...]...

Pour les lecteurs physiques, vous pouvez mettre des valeurs '''hexadécimales''' séparées par des virgules pour spécifier les longueurs d'ECM qui sont autorisées.

[[Datei:WarningS.png|text-bottom]] '''Attention:'''En fonctionnement normal, ce paramètre n'est pas nécessaire!

[[Datei:MessageS.png|text-bottom]] '''[[Streamboard:oscam/wiki/ECMLengthList|Liste des longueurs d'ECM]]'''

==== ecmheaderwhitelist ====
{{Pasindispensable}}
NOUVEAU svn7480:09-21-2012

ecmheaderwhitelist = [CAID[@PROVID]:]Header[,Header1,Header2,HeaderN][;[CAID[@PROVID]:]Header[,Header1,Header2,HeaderN]

Configurer l’entête valide de l'ecm pour son reader, c'est pour protéger son reader des entêtes erronés.

Exemple pour un reader local CSAT (032830):
ecmheaderwhitelist = 817040019003032838,807040019003032838,81703A01D2020B024003032838,80703A01D2020B024003032838 ......

Exemple pour un reader distant (proxy) CSAT (032830):
ecmheaderwhitelist =
0500:817040019003032838,807040019003032838,81703A01D2020B024003032838,80703A01D2020B024003032838
......

ATTENTION: pour CSAT, il y a plusieurs entêtes valides et d'autres erronés, j'en ai mis que quatre valides.

thread [[Streamboard-Thread:34748|ici]]

[[Streamboard:oscam/wiki/HeaderWhitelist|HeaderWhitelist]] ici

==== ratelimitecm ====
{{Pasindispensable}}

Nombre de SID différents autorisés dans les ECM pendant un intervalle déterminé
ratelimitecm = # nombre
= 0 # (valeur par défaut)

==== ecmnotfoundlimit ====
{{Pasindispensable}}
NOUVEAU svn8313:02/07/2013

Pour définir un nombre limit d'ECM de type "not found" (non trouvé) avant redémarrage du reader/lecteur. Par défaut, ce paramètre = 0 çàd qu'il n'y a pas de limite.

Exemple:
ecmnotfoundlimit = 0 # pas de limite [valeur par défaut]
= 10 # réinitialisation du lecteur au bout de 10 ECM "not found"

==== resetcycle ====
{{Pasindispensable}}
NOUVEAU svn5821:08/12/2011

Réinitialisation automatique du lecteur toutes les X trames ECM

[[Datei:WarningS.png|text-bottom]] '''Valable uniquement pour des Reader physiques'''

Exemple:
resetcycle = 0 # désactivé [valeur par défaut]
= 5 # réinitialisation du lecteur au bout de 5 trames ECM

==== ratelimitseconds ====
{{Pasindispensable}}

OBSOLÈTE svn9078:09/12/2013 remplacer par ratelimittime!

Intervalle pour la ratelimit (voir ratelimitecm)
ratelimitseconds = # secondes
= 0 # (valeur par défaut)
 

==== ratelimittime ====
{{Pasindispensable}}

NOUVEAU svn9078:09/12/2013

Intervalle pour la ratelimit (voir ratelimitecm)
ratelimittime = # millisecondes
= 0 # (valeur par défaut)
 

==== ecmunique ====
{{Pasindispensable}}

NOUVEAU svn8491:03/06/2013

ecmunique = 0|1

1 = Vérification de la table de hachage correspondant au rateLimitStatus ECM
0 = Par défaut

 

==== srvidholdseconds ====
{{Pasindispensable}}

OBSOLÈTE svn9078:09/12/2013 remplacer par srvidholdtime!

srvidholdseconds = secondes

Période pendant laquelle le service-ID est maintenu dans le "slot" avant d'expirer. Cette période de temps est combinée avec le test ecmunique. Par défaut = 0
 

==== srvidholdtime ====
{{Pasindispensable}}

NOUVEAU svn9078:09/12/2013

srvidholdtime = millisecondes

Période pendant laquelle le service-ID est maintenu dans le "slot" avant d'expirer. Cette période de temps est combinée avec le test ecmunique. Par défaut = 0
 

==== cooldowndelay ====
{{Pasindispensable}}

NOUVEAU svn5946:09/09/2011

cooldowndelay = délai,durée (cooldown=<seconds OFF>, <seconds ON>)
= [blank] défaut

Ce paramètre marche uniquement dans le cas où 'ratelimitecm' + 'ratelimitseconds' sont configurés.

Pendant 'seconds OFF', le lecteur est ouvert. Après 'seconds OFF', le lecteur exécute les restrictions configurées dans 'ratelimitecm' + 'ratelimitseconds' pour le temps défini dans 'seconde ON'.

Donc cooldow ON signifie que le lecteur est limité (restreint aux paramètres 'ratelimitecm' + 'ratelimittime'), cooldown OFF signifie que le lecteur est ouvert.

Référez-vous à la doc pour plus d'informations.

==== blocknano ====
{{Pasindispensable}}

Liste les Nanos EMM (en hexadécimal) ou tous les Nanos EMM à bloquer. Ne s’applique qu’aux Readers physiques

Exemple
blocknano = 45,93,7a,ff
= all ( tous )
= # [rien] aucun (valeur par défaut)

==== blockemm-u ====
{{Pasindispensable}}

''Bloque les EMM-U = EMM-Unique çàd les EMM uniques. Les EMM-U sont envoyés à une seule carte pour un diffuseur donné ''
blockemm-u = 0 # valeur par défaut rien n’est bloqué
blockemm-u = 1 # bloque les EMM directement adressé à la carte

==== blockemm-s ====
{{Pasindispensable}}

''Bloque les EMM-S = EMM-Shared çàd les EMM partagés. Les EMM-S sont envoyés à un groupe de cartes pour un diffuseur donné''
blockemm-s = 0 # valeur par défaut rien n’est bloqué
blockemm-s = 1 # bloque les EMM adressés à un groupe de cartes

==== blockemm-g ====
{{Pasindispensable}}

''Bloque les EMM-G = EMM-Global çàd les EMM globaux envoyés à TOUTES les cartes pour un diffuseur donné ''
blockemm-g = 0 # valeur par défaut rien n’est bloqué
blockemm-g = 1 # bloque les EMM adressés à toutes les cartes

==== blockemm-unknown ====
{{Pasindispensable}}

''Bloque les EMM-U = EMM-Unknown çàd les EMM inconnus (en l'état des connaissances publiques) d'un contrôle d'accès pour un diffuseur donné''
blockemm-unknown = 0 # valeur par défaut rien n’est bloqué
blockemm-unknown = 1 # bloque tous les EMM inconnus

==== blockemm-bylen ====
{{Pasindispensable}}

NOUVEAU svn5548

MODIFICATIONS svn8615:04/12/2013
blockemm-bylen = [longueur min-longueur max, longueur , longueur 2, longueur n]...
(décimal)
''Bloque les EMM avec un paramètre LEN/LL (longueur d'instruction) pour un diffuseur donné''

Exemple
blockemmbylen = 1-10,11-

Bloquer tous les EMM avec les longueurs définies, indépendant de blockemm-g/blockemm-s/blockemm-u.
Les valeurs sont en décimal.
10 valeurs autorisées.

 

==== via_emm_global ====
{{Pasindispensable}}
NOUVEAU svn9843:09/05/2014

via_emm_global = 0|1

Permet le filtrage des EMM globaux de type EMM-G pour le contrôle d'accès '''Viaccess'''

'''Paramètre applicable uniquement pour le protocole camd35 (cs357x)!'''

0 = valeur par défaut

 

==== saveemm-u ====
{{Pasindispensable}}

NOUVEAU svn5947:09/09/2011

saveemm-u = 0 (défaut)
= 1

Paramètre permettant de sauvegarder les EMMs uniques de type EMM-U = EMM-Unique çàd EMMs envoyé à une seule carte pour un diffuseur donné à partir de l'Unique Address (le numéro de série de la carte au format hexadécimal). Par défaut = 0 (sauvegarde d'EMM-U désactivée). Pour que les EMM-U soient sauvegardés/enregistrés, l'emplacement du fichier doit être spécifiée dans le paramètre <emmlogdir> de la section [global] du fichier 'oscam.conf'.

==== saveemm-s ====
{{Pasindispensable}}

NOUVEAU svn5947:09/09/2011

saveemm-s = 0 (défaut)
= 1

Paramètre permettant de sauvegarder les EMMs partagés de type EMM-S (cf. infra) dans un fichier. Par défaut = 0 (sauvegarde d'EMM-U désactivée). Pour que les EMM-S soient sauvegardés/enregistrés, l'emplacement du fichier doit être spécifiée dans le paramètre <emmlogdir> de la section [global] du fichier 'oscam.conf'.

==== saveemm-g ====
{{Pasindispensable}}

NOUVEAU svn5947:09/09/2011

saveemm-g = 0 (défaut)
= 1

Paramètre permettant de sauvegarder les EMMs globaux de type EMM-G (cf. infra) dans un fichier. Par défaut = 0 (sauvegarde d'EMM-G désactivée). Pour que les EMM-G soient sauvegardés/enregistrés, l'emplacement du fichier doit être spécifiée dans le paramètre <emmlogdir> de la section [global] du fichier 'oscam.conf'.

==== saveemm-unknown ====
{{Pasindispensable}}

NOUVEAU svn5947:09/09/2011

saveemm-unknown = 0 (défaut)
= 1

Paramètre permettant de sauvegarder les EMMs inconnus (cf. infra) dans un fichier. Par défaut = 0 (sauvegarde d'EMM inconnu désactivée). Pour que les EMM inconnus soient sauvegardés/enregistrés, l'emplacement du fichier doit être spécifiée dans le paramètre <emmlogdir> de la section [global] du fichier 'oscam.conf'.

==== savenano ====
{{Pasindispensable}}
OBSOLÈTE svn 5946:09/09/2011

Ce paramètre est remplacé par '''saveemm-[u,s,g,unknown]''' qui sauvegardent les EMMs séparément selon le type configuré.

Liste des Nanos EMM, ou tous les Nanos EMM (en hexadécimal) qui doivent être sauvegardés en emmlogdir

Format
nano[,nano]....|all

Exemple
savenano = 45,93,7a,ff
= all # tous
= # aucune (valeur par défaut)

==== readnano ====
{{Pasindispensable}}

'''Valable uniquement pour des Reader physiques'''

Ecrit les données (copie exécutée lors du savenano) sur la carte Si aucun chemin n’est déterminé, le fichier est recherché dans le répertoire "config ".

Exemple
readnano = write.emm
= /var/oscam/write.emm
= # [rien] (valeur par défaut)

==== read_old_classes ====
{{Pasindispensable}}
NOUVEAU svn10443:02/08/15

'''Valable uniquement pour des Reader physiques'''

Ce paramètre gère l'affichage des classes/entitlements expirés (classes antérieures au mois en cours) des cartes Viaccess.

read_old_classes = 0 # ne lit pas les classes/entitlements expirés cela accélère le démarrage d'OScam (par défaut)
= 1 # lit et affiche les classes/entitlements expirés

Exemple
read_old_classes = 1 va afficher l'ensemble des classees/entitlements présents sur la carte.

==== use-ssl ====
{{Pasindispensable}}

NOUVEAU svn8725:06/25/20113

Ce paramètre permet d'activer (ou pas) le protocole SSL (Secure Socket Layer)

use_ssl = 1 # utilise le SSL pour le protocole ghttp
= 0 # n'utilise pas le SSL pour le protocole ghttp (valeur par défaut)

==== dropbadcws ====
{{Pasindispensable}}

MODIFICATIONS svn5992:10/22/2011

dropbadcws = 0|1

dropbadcws = 1 # CW est de retour comme incorrect, send "introuvable" à la place incorrect CWs
= 0 # default

==== disablecrccws ====
{{Pasindispensable}}

NOUVEAU svn6004:10/26/2011

disablecrccws = 0|1

1 = désactive le crc pour cws, par défaut = 0

En mode nominal, ce paramètre n'est pas nécessaire. En activant ce paramètre les trames ne respectent plus la norme DVB.

==== lb_weight ====
{{Pasindispensable}}

Plus la valeur est élevée, plus grande est la probabilité que le reader sera choisis. Il est un indicateur du temps moyen de réponse au sein de l'équilibrage de charge (Loadbalancing).
lb_weight = xxxx
= # [rien] Valeur par défaut : 100
[[Datei:Lb_weight_calc2.png]]

La première colonne reprend les temps de réponse des reader. La première ligne reprend les valeurs lb_weight.
L'intersection des deux donne le temps de réponse corrigé en fonction du lb_weight

'''Exemple:'''

Vous avez deux readers avec un temps de réponse de 400ms. Vous voulez privilégier un reader en faisant croire que son temps de réponse est de 300ms.

Dans le tableau, vous repérez la ligne qui commence par 400, vous recherchez dans cette ligne la valeur 300 . Dans l'entête de colonne vos trouvez la valeur LB_weight à donner au reader(130). En entrant cette donnée, vous privilégiez ce reader.

==== lb_whitelist_services ====
{{Pasindispensable}}
NOUVEAU svn8656:22/05/2013

lb_whitelist_services = <services>,<services>....

les services repris dans les groupes de services définis dans ce paramètre ne seront jamais bloqués (mis en "not found") par le loadbalancer (répartisseur de charge), par défaut=aucun
Autrement dit, le loadbalancer essayera toujours d'utiliser ces services sur votre carte, il ne pourra plus jamais décider de ne plus interroger votre carte pour ces services.
 
 
==== lb_force_fallback ====
{{Pasindispensable}}

NOUVEAU - svn9739:05/19/2014

lb_force_fallback = 0|1

1 = setzt den Reader ständig in fallback-modus für das load balancing ohne Berücksichtigung der reader statistics,
0 = default
 
 

==== ccc ====
===== cccversion =====
{{Version}}

'''Seulement pour CCcam '''

Définit la version de CCcam à utiliser.
<nowiki><mainversion>,<version>,</nowiki>

Exemple
cccversion = 1.2.34

===== cccmaxhops =====
{{Version}}

Définit la distance maximale en hop (saut) de repartage de la carte
0 = Uniquement la carte locale
1 = Carte locale + 1 Hop
2 = Carte locale + 2 Hops
Et ainsi de suite
Valeur par défautt = 10

===== ccchop =====
{{Pasindispensable}}

ccchop =

Pour les readers '''non CCcam'''; hop pour les cartes virtuelles.

===== cccreshare =====
{{Version}}

MODIFICATIONS svn8607:04/10/2013

Définit le Reshare-hop pour CCcam lecteur

cccreshare = -1 # utilisation du niveau [[OSCam/fr/Config/oscam.conf#reshare|reshare]] défini dans oscam.conf - defaut
= 0 # repartage pour les clients directs
= 1 # repartage pour les clients directs et 1 niveau supplémentaire
= x # repartage pour les clients directs et x niveau(s) supplémentaire(s) (x correspond au nombre de niveau)

Reshare peut être défini de 2 façons:

* Dans oscam.server [lecteur] ("cccreshare")
* Dans oscam.user [compte] ["cccreshare")

La valeur de Reshare correspond à la plus petite valeur des 2 paramètres !

===== cccwantemu =====
{{Version}}

Demande pour recevoir un emu du server cccam.
cccwantemu = 1 # activé, demande l’ému
= 0 # désactivé, valeur par défaut

===== ccckeepalive =====
{{Version}}

Envois un message “keepalive ", pour garder la connexion avec un server CCCam distant.
ccckeepalive = 1 # activé, envois le message "keep alive"
= 0 # désactivé, valeur par défaut

===== cccreconnect =====
{{Pasindispensable}}

cccreconnect = timeout (en mile-secondes)

Ce délais de demende d'ECM est le temps que oscam attend avant de se reconnecter au reader cccam, par défaut = 12000
Uniquement pour un reader utilisant un cccam-original. Pour un cccam-ext, le paramètre est ignoré.

===== cccmindown =====
{{Version}}

Par exemple:
cccmindown = 0 oscam n'ignorera aucune carte.

cccmindown = 1 oscam ignorera les cartes avec reshare 0, il conservera uniquement les carte qui ont reshare 1 ou plus.

cccmindown = 2 oscam ignorera les cartes avec reshare 0 et 1, il conservera uniquement les carte qui ont reshare 2 ou plus.

cccmindown = 3 oscam ignorera les cartes avec reshare 0, 1 et 2, il conservera uniquement les carte qui ont reshare 3 ou plus.

Etc.....

 
 
==== '''gbox''' ====
NOUVEAU svn8350:02/15/2013
 
 
'''Beispiel einer funktionierenden Minimal-Konfiguration:'''

Angenommen die Gbox läuft auf Host 192.168.1.101 und OSCam liegt auf 192.168.1.123. Im File '''cwshare.cfg''' auf der GBox-Seite stehen z.B. folgende Eintragungen:
M:{192.168.1.101{A123BCDE}}
D:{192.168.1.123{3820 3819{98AF3E25{A3 A3}}}}
Wenn sich oscam_gbox mit der originalen GBOX von oben verbinden soll, dann sieht die Konfiguration auf OSCam so aus:
'''oscam.conf:'''
[gbox]
hostname = 192.168.1.123
my_password = 98AF3E25
port = 3819

'''oscam.server:'''
[reader]
protocol = gbox
group = 1
device = 192.168.1.101,3820
password = A123BCDE
user = gbox_client

 
 
===== device =====
{{Obligatoire}}

device = Komma-separierte Liste mit den Werten

peer's IP oder Hostname
peer's port

Beispiel:
192.168.1.101,3820

 

===== password =====
{{Obligatoire}}

password = 4 hex bytes, 8 chars

Peer Passwort

Beispiel:
A123BCDE

 

===== my_password =====
{{Obligatoire}}

OBSOLÉTE svn9163:12/31/2013 '''moved to oscam.conf [gbox]'''

Passwort = 4 hex bytes, 8 chara

Mein Passwort

Beispiel
98AF3E25

 

===== gbox_reshare =====
{{Pasindispensable}}

Reshare-Level für lokale Karte(n), default = 0

 

===== gbox_max_distance =====
{{Pasindispensable}}

gbox_max_distance = maximale Distanz zum Empfang von peer-cards, default = 2

 

===== gbox_max_ecm_send =====
{{Pasindispensable}}

gbox_max_ecm_send = sende ecm zu maximal n peer cards, default = 3

 

===== user =====
{{Obligatoire}}

Benutzername (client) der oscam gbox

Beispiel:
user = gbox_client

[[Datei:WarningS.png|text-bottom]] '''Attention:'''
'''Der user muss auch in der oscam.user [account] eingetragen werden!

'''Unter [reader] und [account] sollten geeignete Filter gesetzt werden (services=, caid=, ident=), um Instabilitäten der Gbox
'''durch Überfluten mit Karten zu vermeiden.

 

{{OSCamTranslatedLinks}}