5.3.2 supp

The Supp process handle PUBLISHER queries about supports. A score is computed for each local support, based on its age (t). However if support wasn’t checked recently (checkTTL) its score is set to 0 as it is supposed to be corrupted or lost.

t <= T: score = ({T-t \over T})^{-a} *(M-b))+b
t > T: score = ({1 + c*(t-T)}^{-1}) * b

where: (default values)

T = 10 years

is the support time to live (suppTTL)

t

is the current support age

a = 2

power that reduce score from age of supports (powSupp)

M = 10.00

the maximum score (maxScore)

b = 1.00

maximum score for outdated supports (badScore)

c = 2

factor that reduce score of out-dated supports (factSupp)

Notice: with the default values this gives:
t <= T: score = (\sqrt{T-t \over T} *(9))+1
t > T: score = {1 \over 1 + 2*(t-T)}

Notice:

• The same formula apply for local and shared scores (respectively given by $ mediatex ls supp or written into /etc/mediatex/mdtx-COLL/servers.txt file). So theses parameters appears both into /etc/mediatex/mdtx.conf and /etc/mediatex/mdtx-COLL/servers.txt.
• for support’s files, the score is constant and given by the fileScore parameter from /etc/mediatex/mdtx.conf file was checked recently (fileTTL), else score is set to 0 as it is supposed to be deleted from the file-system.

Process conceptual model:

• Events in

  $ mediatex ls supp

  $ mediatex add supp supp on path

  $ mediatex add file path

  $ mediatex del supp supp

  $ mediatex note supp supp as text

  $ mediatex check supp supp on file

  from PUBLISHER (see Who): manage local supports.

• Processing
  • Manage supports information related to the ~mdtx/git/mdtx/supports.txt (see supports.txt) file.
  • Automatically withdraw a support from all collection on removal.
  • When PUBLISHER provides a support, ensure the SERVER (see Server) may work with it.
• Events out

  withdraw_supp()

  to conf (see conf): withdraw a local supports from collections.

  # /usr/share/mediatex/scripts/mount.sh

  # /usr/share/mediatex/scripts/umount.sh

  to mount-umount (see mount-umount): manage mounting ISO devices.

  <have>

  to have (see have): tels SERVER a support is now available.

• Data in/out
  • /etc/mediatex/mdtx.conf (see mdtx.conf)
  • ~mdtx/git/mdtx/supports.txt (see supports.txt)
  • /etc/mediatex/mdtx-COLL/servers.txt (see servers.txt)

Examples:

• Manage supports: see Scenario 1.

Code:

src/common/upgrade.c

src/client/supp.c