Streamboard Wiki - Benutzerbeiträge [de-at]

OSCam/en/Config/oscam.server

2012-12-05T19:34:34Z

Nm1: /* protocol */

[[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")
= camd35|cs357x (cascading - camd 3.5-compatible remote server)
= mp35
= smartreader
= serial
= cs378x
= gbox
= newcamd|newcamd525
= newcamd524
= cccam
= radegast
= pcsc
= constcw
= sc8in1
= smargo

==== device ====
{{required}}
<device|bus:device|device:slot>|Serial:Reader serial|<ip|hostname>,<port>[,<lport>]|pcsc|<0|1>|constantcw

device: device name (eg myreader)

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

device:slot: device name and slot number sc8in1 or MCR [1-8]

serial: serial number of Smartreader+
(get the serial number while starting OSCam)

lport: remapping to local 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
constant CW file format:
CA (4 digits):
ID (6 digits):
SID (4 digits):
PMT PID (4 digits):
ECM PID (4 digits)::
key (16 Bytes separated by spaces)

eg: 1234:123456:1234:1234:1234::00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F

Examples
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'''
Detect = CD (Carrier Detect) - default -
Detect = DSR (Data Set Ready)
Detect = CTS (Clear To Send)
Detect = RING (Ring Indicator)
Detect = NONE (detect switched off, but signal "card is in"
Detect = gpio1 ... gpio7 (neu für mipsel-uclibc)

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

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

auto clock speed in '''Dreambox mode''' set to -1

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

==== mhz ====
{{Optional/en}}
CHANGE svn 7045+7047:06/12-14/12

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

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

For cardmhz switching to '''MIPSEL Dreambox mode''' set to 2700, for cardmhz switching to '''PPC Dreambox mode''' set to 3150.

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

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

set endpoint address for FTDI chips
0x81: Infinity USB Smart
0x82: Smartreader+ (default)

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

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

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

==== 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
Add TA1 Byte for '''NDS Videoguard 2 SCs'''

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

==== boxkey ====
{{Optional/en}}
box key for Nagravision SCs / CAM key for Irdeto SCs

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

pincode for '''Conax and Cryptoworks''' 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 = 0100@012345:000102030405060708090a0b0c0d0e0f;0200@543210:0,0,0f0e0d0c0b0a090807060504030201

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

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'''!

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)

==== 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 = 2 # timeout in 2 seconds
= 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

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

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

* <usecache> 0 = # disabled EMM caching (default)
* <usecache> 1 = # enabled EMM caching

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

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

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

Example
emmcache = 1,3,10 # Cache on, write 3 x, log written (2) and blocked (8) = 10
emmcache = 1,2,6 # Cache on, write 2 x, log written (2) and skipped (4) = 6

==== 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[@ident]:]lenght[,lengtht]...[;[CAID[@ident]:]lenght[,lengtht]...]...

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

example
ecmwhitelist = 10,20,30,0a,0b,0c
= 0100:10,20;0200@12345:0a,4b
[blank] = none (default) and ident 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)

==== resetcycle ====
{{Optional/en}}
NEW svn5821: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

==== ratelimitseconds ====
{{Optional/en}}

interval for rate limit in seconds
ratelimitseconds = # seconds
= 0 # (default)

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

NEW svn5946:09/09/2011

cooldown

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

'''parameter "ratelimitecm" and "ratelimitseconds" 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}}

blockemm-bylen = [length,length]... (decimal)

block all types of EMMs by length, maximum 10 values, default: none

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

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

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

Define reader's CCcam reshare hop

cccreshare = -1 # use [[OSCam/en/Config/oscam.conf#reshare|reshare]] level defined in oscam.conf - default
cccreshare = 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}}

cccmindown = # number
= 0 # default

Filters all readers with hops smaller than number

{{OSCamTranslatedLinks}}

OSCam/en/Config/oscam.conf

2011-11-24T18:23:00Z

Nm1: CCCamReshareModeParameter()

[[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 [http://www.valleypistachio.com/buy pistachios] 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 !

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

Bind service to specified IP-address

Example:
serverip = 192.168.178.1

Default:
serverip =

OSCam listen to all IP's.

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

Value to delay cached requests

Example:
cachedelay = 300

Default:
cachedelay = 0

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

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

You can define a maximum of [http://www.andrewflusche.com/services/spotsylvania-reckless-driving-defense/Spotsylvania reckless driving] one filename (not more!) and additionally to log to stdout or syslog (you can also only log to stdout or syslog and omit the filename).

Opportunities:

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

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

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

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

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

loghistorysize = bytes

size of log message history in web interface or monitor

0 = disabled
[blank] = 4096 (default)

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

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

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

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

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

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

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

==== 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 [http://www.diamondlinks.net/link building] 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

Example:
emmlogdir = /var/log/emm.log

Default:
emmlogdir = # [blank] no path fpr emm-log

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

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

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

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

value for client process being idle before disconnect in seconds

Example:
clientmaxidle = 200 # Disconnect after 200 seconds

Default:
clientmaxidle = 120 # Disconnect after 120 seconds

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

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

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

Example:
bindwait = 20 # waiting time 20 seconds

Default:
bindwait = 120 # waiting time 120 seconds

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

network priority

Beispiel:
netprio = 1 # Priority 1

Default:
netprio = 0 # system given

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

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

Example:
resolvegethostbyname = 1 # gethostbyname

Default:
resolvegethostbyname = 0 # adressinfo system given

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

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

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

Default:
failbantime = 0 # failban off (default)

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

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

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

'''Only Seca and Viaccess'''

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

Example:
unlockparental = 1 # parental lock mode disabled

Default:
unlockparental = 0 # parental lock mode enabled

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

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

'''Only using Serialreader!'''

timeout for serial reader in milli-seconds

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

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

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

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

wait for local SCs on startup before opening network ports

Example:
waitforcards = 0 # don't wait

Default:
waitforcards = 1 # wait

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

waitforcards_extra_delay = milli seconds

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

default = 500

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

try decoding on local cards first

Example:
preferlocalcards = 1 # prefer local cards

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

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

waiting time in seconds beetween restarts

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

Default:
readerrestartseconds = 5 # waiting time 5 seconds

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

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

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

Default:
saveinithistory = 0 # no save

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

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

suppresscmd08 = 0|1

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

Can be overwritten in oscam.user!

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

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

'''loadbalance mode'''

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

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

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

Default:
lb_mode = 0 # disabled

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

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

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

Default:
lb_save = 0 # no svae

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

set count of best readers for loadbalancing.

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

Default:
lb_nbest_readers = 1 # requests go to one reader

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

set count of fallback readers for loadbalancing

Example:
lb_nfb_readers = 2 # two fallbackreader

Default:
lb_nfb_readers = 1 # one fallbackreader

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

lb_reopen_mode = 0|1

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

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

CHANGE svn 5893:08/19/2011

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

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

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

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

minimal ECM count to evaluate loadbalancing values

Example:
lb_min_ecmcount = 2 # 2 counts

Default:
lb_min_ecmcount = 5 # 5 counts

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

Maximum ECM count before resetting loadbalancing values.

Example:
lb_max_ecmcount = 200 # 200 counts

Default:
lb_max_ecmcount = 500 # 500 counts

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

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

Example:
lb_reopen_seconds = 500 # retry after 500 seconds

Default:
lb_reopen_seconds = 900 # retry after 900 seconds

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

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

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

Default:
lb_retrylimit = 800

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

Filenanme for saving loadbalancing statistics

default = /tmp/.oscam/stat

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

hours after the loadbalancing statistics will be deleted

default = 336

==== lb_use_locking ====
{{Optional/en}}

disable parallel and identical ECM requests

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

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

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

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

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

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

CHANGE svn:5754:07/31/2011

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

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

default = none

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

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

CHANGE svn 5758:08/01/2011

lb_noproviderforcaid = CAID1[,CAID2]...

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

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

default = none

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

lb_max_readers = limit (number)

restrict the reader count to limit during learning

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

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

lb_auto_betatunnel = 0|1

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

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

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

disablemail = 0|1

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

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

mailfile = file

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

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

{{OSCamConfMonitorParameter}}

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

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

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

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

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

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

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

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

Default
nocrypt = # [blank] no secured monitor connection

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

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

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

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

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

Example
monlevel = 4 # complete access

monlevel can be overwritten per user in oscam.user!

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

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

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

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

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

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

Path for LCD output

Default:
lcd_outputpath = [blank] /tmp

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

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

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

LCD refresh interval (minimum 5), default:10

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

{{OScamConfWebIfParameter}}

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

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

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

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

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

==== httpuser ====
{{required}}

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

==== httppwd ====
{{required}}

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

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

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

path for external CSS file

For webinterface different styles are available.

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

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

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

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

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

status refresh in seconds

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

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

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

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

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

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

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

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

==== httpdyndns ====
{{Optional/en}}

http web interface connections allowed

Example
httpdyndns = my.dynexample.com

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

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

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

read only modus for web interface

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

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

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

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

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

{{OSCamConfCamd35Parameter}}

{{OSCamConfCs357xParameter}}

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

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

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

bind service to specified IP address

Example:
serverip = 192.168.178.1

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

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

suppresscmd08 = 0|1

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

Can be overwritten in oscam.user!

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

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

{{OSCamConfCs378xParameter}}

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

Example:
port = 15000

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

bind service to specified IP address

Example:
serverip = 192.168.178.1

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

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

suppresscmd08 = 0|1

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

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

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

{{OSCamConfNewcamdParameter}}

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

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

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

TCP/IP-Port for CCcam clients, enables Cccam protocol!
port =
= 0 # CCcam-Protokoll disabled (default)

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

define CCcam version, minimum CCcam version 2.0.11.
<nowiki><main version>,<version>,</nowiki>

Example:
version = 1.2.34

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

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

Example:
reshare = 1 resharing only for direct peer

reshare could be defined on 2 ways:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

forward_origin_card = 0|1

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

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

nodeid = ID

set CCcam node ID in hex, default:none

example
nodeid = 0a0b0c0d0e0f1011

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

==== pand_skip_send_dw ====

pand_skip_send_dw = dummy

==== pand_allowed ====

pand_aloowed = dummy

==== pand_usr ====

pand_user = dummy

==== pand_pass ====

pand_pass = dummy

==== pand_ecm ====

pand_ecm = dummy

==== pand_port ====

pand_port = dummy

==== pand_srvid ====

pand_srvid = dummy

=== GBox ===

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

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

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

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

{{OSCamConfDVBapiParameter}}

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

DVB API enabled

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

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

Default:
enabled = # anonymous

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

penalty can be overwritten per user in oscam.user

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

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

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

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

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

{{OSCamTranslatedLinks}}