Bolay's Wiki

User Tools

Site Tools

Trace:
operating_systems:linux:debian:acdsn-ac-fx

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
Last revisionBoth sides next revision
operating_systems:linux:debian:acdsn-ac-fx [2012/11/12 09:00] – created sbolayoperating_systems:linux:debian:acdsn-ac-fx [2012/11/19 14:23] – [cron.txt] tret
Line 30: Line 30:
  
 ==== New ==== ==== New ====
-^ Label                    ^ Arguments ^ Options ^ Comments              ^ +^ Label                    ^ Arguments ^ Options                 ^ Comments              ^ 
-| new address              | a         |         | cannot be broadcasted | +| new address              | a         | <address>               | 1-65535 - cannot be broadcasted | 
-| new bad access timeout   | b         ||| +| new bad access timeout   | b         | <timeout>               | 1-255 | 
-| new valid access timeout | c         |||  +| new valid access timeout | c         | <timeout>               | 1-255 |  
-| new key            | k         ||| +| new key            | k         | <key>                   || 
-| new lock                 | l         |||  +| new lock                 | l         | <device>\t<lock>        | device (1-2) locked (1) or not (0)|  
-| new mode                 | m         |         | slave/device active or not |  +| new mode                 | m         | <device>\t<mode>        | slave (0) or device (1-9) active (0) or not (0) |  
-| new rights               | r         |||  +| new rights               | r         | <user>\t<unit>\t<right> ||  
-| new status & log rotation| s         |||  +| new status & log rotation| s         | -                       ||  
-| new timestamp            | t         |         | only if RTC defined (used to synchronize clock) |  +| new timestamp            | t         | <timestamp>             | only if RTC defined (used to synchronize clock) |  
-| new unit                 | u         |||  +| new unit                 | u         | <>\t<>||  
-| new overdrive speed      | v         |         | put 1-wire devices in overdrive speed | +| new overdrive speed      | v         | <device>\t<overdrive>   | put 1-wire devices in overdrive speed | 
-| new wire                 | w         |||  +| new wire                 | w         | -                       ||  
-| new user                 | x         |||  +| new user                 | x         | <uid>                   ||  
-| new baudrate             | z         ||| +| new baudrate             | z         | <baudrate>              ||
  
 ==== Query ==== ==== Query ====
Line 64: Line 64:
 | query user                 | x         ||| | query user                 | x         |||
  
 +===== Configuration Files =====
 +
 +The configuration files are flat text file where each fields are separated by a tabulation.
 +
 +==== keys.txt ====
 +
 +Contains the list of the key used to hash the credentials on the iButton key. You can generate a new key every day and add it to this file, the most recent key comming first.
 +
 +^ Field Name ^ Description                                               ^ Example                    ^
 +| timestamp  | The timestamp of the time when the key has been generated | 1350028169                 |
 +| key        | The value of the secret key                               | [Z}4V;qr$(/Kc_aiF7#K8tATNC |
 +
 +<file txt demo_keys.txt>
 +1350028169      [Z}4V;qr$(/Kc_aiF7#K8tATNC
 +1349094539      IdRPKslg\?/
 +1349085044      9YxUJ`wa#\U;M18=L,>_bo8wIbn"IoY
 +1349085044      cl8b]It3f,F-b
 +1349085044      ad15lMR{*]P_<koY&=@;cNgr
 +</file>
 +
 +==== units.txt ====
 +
 +Provides a link beetween the unit id and a human readable label.
 +
 +^ Field Name ^ Description                                               ^ Example     ^
 +| id         | The unique identifier of the unit, as used in slaves.conf | 2           |
 +| label      | A human description of the unit                           | Main Office |
 +
 +<file txt demo_units.txt>
 +1       Reception
 +2       Main Office
 +3       CEO's Office
 +</file>
 +
 +==== users.txt ====
 +
 +Contains the list of all users, the timestamp of the last key read from the user and a value which can be incremented
 +when an iButton key is lost or if the data on the iButton key has been copied by some nasty people.
 +
 +^ Field Name ^ Description                                                  ^ Example     ^
 +| id         | The unique identifier the the user, as used in cron.txt      | Arthur Dent |
 +| timestamp  | The timestamp of the last key read for the user              | 1350028169  |
 +| increment  | A value which can be incremented when an iButton key is lost | 3           |
 +
 +<file txt demo_users.txt>
 +Arthur Dent             1350028169      3
 +Ford Prefect            1349085044      2
 +Zaphod Beeblebrox       1349085044      5
 +</file>
 +
 +==== cron.txt ====
 +
 +Contains the rights to access on some unit for a user during a specified time interval (specified as a cron).
 +
 +^ Field Name ^ Description                                                  ^ Example      ^
 +| unit_id    | The number identifying the target unit of this rule          | 1            |
 +| user_id    | The identifier of the user on which this rule applies        | Arthur Dent  |
 +| cron       | The cron value of the accessible periods for this rule       | 0 8-17 * * * |
 +
 +<file txt demo_cron.txt>
 +1       Arthur Dent     0 8-17 * * *
 +2       Arthur Dent     0 8-17 * * *
 +1       Ford Prefect    * * * * *
 +</file>
 +