Streamboard Wiki - Benutzerbeiträge [de-at]

OSCam/en/Config/oscam.srvid2

2015-06-24T23:19:00Z

Aeon: added new [provider] syntax

== oscam.srvid2 ==
'''This file is only needed if operating monitor and webinterface!'''

Mapping between CAID, provider ID, service ID, provider, name, type and description of service. Logging and the ads in webinterface will get a better explanatory power. Dependencies between server, reader and client are more evident.

You only need the oscam.srvid2 when using the monitor or the web interface. For saving memory consumption only insert the service IDs and provider IDs that you really need. Some external programs use their own database and do not need the oscam.srvid2 of OSCam.

'''Please use Unix text file format only.'''

Format:
service ID:CAID1[@PROVID1[@PROVID2[@...]]][,CAID2[@PROVIDA[@PROVIDB[@...]]]]|[channel_name]|[type]|[description]|[provider]

Example:
000a:0001,0002,0003|tv name|tv|my description 1|provider 1
000a:0004,0005,0006|radio name 2|radio|my description 2|provider 2
000b:0006|tv name 3||my description 3|provider 3
000b:0007|tv name 4|||provider 4

caid 100, ALL provids, srvid 1111
0100:1111|x|y|z|v

caid 100, provid 123456, srvid 1111
1111:0100@123456|x|y|z|v

caid 100, ALL provids , srvid 1111
1111:0100@000000x|y|z|v

caid 100, provid 123456, srvid 1111 and caid 200, provid 654321, srvid 1111
1111:0100@123456,0200@654321|x|y|z|v

or
0100@003311:1234|my provider 1|tv name|...
where 0100 is the CAID and 003311 the PROVID (provider ID) and 1234 the SID

A file can be found here: '''[[Srvid|oscam.srvid2]]'''

You can now add the caid '''0000''' (management) and the remaining caids used by a channel. This would avoid the unknown program showing on webif status page. Easy to find the used caids. Switch to channel and you find information here:
2013/10/12 17:45:22 4DB510 c [DVBAPI] Receiver sends PMT command 3 for channel ''0025''
2013/10/12 17:45:22 4DB510 c [ADD PID 0] CAID: '''1702''' ECM_PID: 1725 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 1] CAID: '''1837''' ECM_PID: 1FD1 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 2] CAID: '''1833''' ECM_PID: 1825 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 3] CAID: '''09C4''' ECM_PID: 1B25 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 4] CAID: '''098C''' ECM_PID: 1A25 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 5] CAID: '''0D05''' ECM_PID: 1F25 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 6] CAID: '''0D95''' ECM_PID: 1F26 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 7] CAID: '''0648''' ECM_PID: 1F27 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 8] CAID: '''0D98''' ECM_PID: 1F28 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 9] CAID: '''0650''' ECM_PID: 1F29 PROVID: 000000
would make this line for oscam.srvid:

''0025'':'''0000,1702,1837,1833,09C4,098C,0D05,0D95,0648,0D98,0650'''|AXN Action|TV|austriasat 19.2°E

showing the end result in webif:
2013/10/12 17:45:22 4DB510 c [DVBAPI] Receiver wants to demux srvid 0025 on adapter 0000 camask 0001 index 0000
2013/10/12 17:45:22 4DB510 c New program number: 0025 (AXN Action) [pmt_list_management 3]

For FTA (free-to-air channels), this works to:
'''FFFE@FFFFFE''':''2404''|Film4|TV|Freesat 28.2°E
FTA caid changed from 0000 to FFFE, provid changed from 000000 to FFFFFE, management CAID stays 0000 for multicrypt

''Note 1'':
If you have these two lines:
1111:0100@123456|a|b|c|d
1111:0100@000000|x|y|z|v

caid 0100, provid 123456, srvid 1111 will get a|b|c|d, and caid 0100, all other provids, srvid 1111 will get x|y|z|v
-> '''Non-zero''' provids are priority before zero-"catch-all"-provids

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.srvid2

2015-06-24T20:46:41Z

Aeon:

== oscam.srvid2 ==
'''This file is only needed if operating monitor and webinterface!'''

Mapping between CAID, provider ID, service ID, provider, name, type and description of service. Logging and the ads in webinterface will get a better explanatory power. Dependencies between server, reader and client are more evident.

You only need the oscam.srvid2 when using the monitor or the web interface. For saving memory consumption only insert the service IDs and provider IDs that you really need. Some external programs use their own database and do not need the oscam.srvid2 of OSCam.

'''Please use Unix text file format only.'''

Format:
service ID:CAID1[@PROVID1[@PROVID2[@...]]][,CAID2[@PROVIDA[@PROVIDB[@...]]]]|[channel_name]|[type]|[description]

Example:
000a:0001,0002,0003|tv name|tv|my description 1
000a:0004,0005,0006|radio name 2|radio|my description 2
000b:0006|tv name 3||my description 3

caid 100, ALL provids, srvid 1111
0100:1111|x|y|z|v

caid 100, provid 123456, srvid 1111
1111:0100@123456|x|y|z|v

caid 100, ALL provids , srvid 1111
1111:0100@000000x|y|z|v

caid 100, provid 123456, srvid 1111 and caid 200, provid 654321, srvid 1111
1111:0100@123456,0200@654321|x|y|z|v

or
0100@003311:1234|my provider 1|tv name|...
where 0100 is the CAID and 003311 the PROVID (provider ID) and 1234 the SID

A file can be found here: '''[[Srvid|oscam.srvid2]]'''

You can now add the caid '''0000''' (management) and the remaining caids used by a channel. This would avoid the unknown program showing on webif status page. Easy to find the used caids. Switch to channel and you find information here:
2013/10/12 17:45:22 4DB510 c [DVBAPI] Receiver sends PMT command 3 for channel ''0025''
2013/10/12 17:45:22 4DB510 c [ADD PID 0] CAID: '''1702''' ECM_PID: 1725 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 1] CAID: '''1837''' ECM_PID: 1FD1 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 2] CAID: '''1833''' ECM_PID: 1825 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 3] CAID: '''09C4''' ECM_PID: 1B25 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 4] CAID: '''098C''' ECM_PID: 1A25 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 5] CAID: '''0D05''' ECM_PID: 1F25 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 6] CAID: '''0D95''' ECM_PID: 1F26 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 7] CAID: '''0648''' ECM_PID: 1F27 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 8] CAID: '''0D98''' ECM_PID: 1F28 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 9] CAID: '''0650''' ECM_PID: 1F29 PROVID: 000000
would make this line for oscam.srvid:

''0025'':'''0000,1702,1837,1833,09C4,098C,0D05,0D95,0648,0D98,0650'''|AXN Action|TV|austriasat 19.2°E

showing the end result in webif:
2013/10/12 17:45:22 4DB510 c [DVBAPI] Receiver wants to demux srvid 0025 on adapter 0000 camask 0001 index 0000
2013/10/12 17:45:22 4DB510 c New program number: 0025 (AXN Action) [pmt_list_management 3]

For FTA (free-to-air channels), this works to:
'''FFFE@FFFFFE''':''2404''|Film4|TV|Freesat 28.2°E
FTA caid changed from 0000 to FFFE, provid changed from 000000 to FFFFFE, management CAID stays 0000 for multicrypt

''Note 1'':
If you have these two lines:
1111:0100@123456|a|b|c|d
1111:0100@000000|x|y|z|v

caid 0100, provid 123456, srvid 1111 will get a|b|c|d, and caid 0100, all other provids, srvid 1111 will get x|y|z|v
-> '''Non-zero''' provids are priority before zero-"catch-all"-provids

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.srvid2

2015-06-24T20:46:15Z

Aeon: fixed description field (its not the provider)

== oscam.srvid2 ==
'''This file is only needed if operating monitor and webinterface!'''

Mapping between CAID, provider ID, service ID, provider, name, type and description of service. Logging and the ads in webinterface will get a better explanatory power. Dependencies between server, reader and client are more evident.

You only need the oscam.srvid2 when using the monitor or the web interface. For saving memory consumption only insert the service IDs and provider IDs that you really need. Some external programs use their own database and do not need the oscam.srvid2 of OSCam.

'''Please use Unix text file format only.'''

Format:
service ID:CAID1[@PROVID1[@PROVID2[@...]]][,CAID2[@PROVIDA[@PROVIDB[@...]]]]|[channel_name]|[type]|[description]

Example:
000a:0001,0002,0003|tv name|tv|my description1
000a:0004,0005,0006|radio name 2|radio|my description
000b:0006|tv name 3||my description

caid 100, ALL provids, srvid 1111
0100:1111|x|y|z|v

caid 100, provid 123456, srvid 1111
1111:0100@123456|x|y|z|v

caid 100, ALL provids , srvid 1111
1111:0100@000000x|y|z|v

caid 100, provid 123456, srvid 1111 and caid 200, provid 654321, srvid 1111
1111:0100@123456,0200@654321|x|y|z|v

or
0100@003311:1234|my provider 1|tv name|...
where 0100 is the CAID and 003311 the PROVID (provider ID) and 1234 the SID

A file can be found here: '''[[Srvid|oscam.srvid2]]'''

You can now add the caid '''0000''' (management) and the remaining caids used by a channel. This would avoid the unknown program showing on webif status page. Easy to find the used caids. Switch to channel and you find information here:
2013/10/12 17:45:22 4DB510 c [DVBAPI] Receiver sends PMT command 3 for channel ''0025''
2013/10/12 17:45:22 4DB510 c [ADD PID 0] CAID: '''1702''' ECM_PID: 1725 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 1] CAID: '''1837''' ECM_PID: 1FD1 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 2] CAID: '''1833''' ECM_PID: 1825 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 3] CAID: '''09C4''' ECM_PID: 1B25 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 4] CAID: '''098C''' ECM_PID: 1A25 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 5] CAID: '''0D05''' ECM_PID: 1F25 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 6] CAID: '''0D95''' ECM_PID: 1F26 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 7] CAID: '''0648''' ECM_PID: 1F27 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 8] CAID: '''0D98''' ECM_PID: 1F28 PROVID: 000000
2013/10/12 17:45:22 4DB510 c [ADD PID 9] CAID: '''0650''' ECM_PID: 1F29 PROVID: 000000
would make this line for oscam.srvid:

''0025'':'''0000,1702,1837,1833,09C4,098C,0D05,0D95,0648,0D98,0650'''|AXN Action|TV|austriasat 19.2°E

showing the end result in webif:
2013/10/12 17:45:22 4DB510 c [DVBAPI] Receiver wants to demux srvid 0025 on adapter 0000 camask 0001 index 0000
2013/10/12 17:45:22 4DB510 c New program number: 0025 (AXN Action) [pmt_list_management 3]

For FTA (free-to-air channels), this works to:
'''FFFE@FFFFFE''':''2404''|Film4|TV|Freesat 28.2°E
FTA caid changed from 0000 to FFFE, provid changed from 000000 to FFFFFE, management CAID stays 0000 for multicrypt

''Note 1'':
If you have these two lines:
1111:0100@123456|a|b|c|d
1111:0100@000000|x|y|z|v

caid 0100, provid 123456, srvid 1111 will get a|b|c|d, and caid 0100, all other provids, srvid 1111 will get x|y|z|v
-> '''Non-zero''' provids are priority before zero-"catch-all"-provids

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2015-06-24T18:53:25Z

Aeon:

[[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

===== 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

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 hops
l = length
o = ONID
p = provider ID
s = service ID
w = CW

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
(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)

==== 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 (clienttimeout in seconds < 100, else milli-seconds) for client process to wait for key

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

Default:
clienttimeout = 5 # after 5 seconds timeout

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

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

value for client process being idle before disconnect in seconds

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

Default:
clientmaxidle = 120 # Disconnect after 120 seconds

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

suppresscmd08 = 0|1

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

Can be overwritten in oscam.user!

More here:: [[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_reopenalways =====
{{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_time_out_t =====
{{Optional/en}}
NEW svn 7564:10/02/2012

lb_auto_time_out_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)

==== httpiconpath ====
{{Optional/en}}
NEW svn:9463/01/28/2014

httpiconpath = 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
 
 

=== 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 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

1 = try to retrieve the channel name and the provider name to update oscam.srvid2 and oscam.provid automatically if information doesn't exist yet.
0 = default

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

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

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

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

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

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

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

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

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

penalty can be overwritten per user in oscam.user

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

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

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

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

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

==== 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}}