home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / OS2CAT11.ARC / USERFILE.DOC < prev   
Text File  |  1992-01-29  |  4KB  |  78 lines

  1. This file describes the layout of user records in Kitten's USERS.CAT file.
  2.  
  3. Kitten is written mostly in C, so all strings are null terminated and all 
  4. dates/times are given as long integer seconds since the beginning of 1970.
  5.  
  6. Also, "today" means on the last day the user called.
  7.  
  8.  
  9.     Offset    Length    Type      Description
  10.     ======    ======    ====      ===========
  11.        0         1      byte      Record type (always zero)
  12.        1        36      string    User name
  13.       37        40      string    City and state
  14.       77        10      string    Password
  15.       87         2      unsigned  Number of times user has called (total)
  16.       89         2      unsigned  Number of times user has called (today)
  17.       91         4      long      Date/time of last logon
  18.       95         4      long      Date/time of last file listing
  19.       99         4      long      Date/time of last message access
  20.      103         2      bitfield  Flags
  21.                         2 bits    Access level (0=twit, 3=super)
  22.                         1 bit     Reviewed
  23.                         1 bit     Delete
  24.                         1 bit     News has been read
  25.                         1 bit     Keep
  26.                         1 bit     Hacker
  27.                         1 bit     Linefeeds required
  28.      105         4      long      User flags (low bit is U0)
  29.      109         4      long      User control flags (defined flags only)
  30.      113         1      byte      Rows per page
  31.      114         1      byte      Columns per row
  32.      115         1      byte      Nulls to send after CR
  33.      116         2      unsigned  Files downloaded (total)
  34.      118         4      long      Bytes downloaded (total)
  35.      122         2      unsigned  Files downloaded (today)
  36.      124         4      long      Bytes downloaded (today)
  37.      128         2      unsigned  Files uploaded (total)
  38.      130         4      long      Bytes uploaded (total)
  39.      134         2      unsigned  Files uploaded (today)
  40.      136         4      long      Bytes uploaded (today)
  41.      140       104      long*26   Numeric variables (26 longs, A to Z)
  42.      244         1      byte      Protocol index (S=SEAlink, X=Xmodem, etc)
  43.      245         1      byte      Spare, unused
  44.      246         4      long      Total time connected, in seconds
  45.      250         4      long      Time connected today, in seconds
  46.      254        16      string    Last known Called*ID number
  47.      270        16      string    Previous known Caller*ID number
  48.      286         2      int       Caller*ID option flags (see note)
  49.      288         4      long      Date/time of first logon ever
  50.      292        13      string    Name of user sound file
  51.      305        13      string    Name of user survey data file
  52.      318         4      long      Pointer into survey data file
  53.      322         4      long      Length of user survey data (in bytes)
  54.      326         2      int       Line number, if online now
  55.      328       184      *         Expansion area, unused
  56.  
  57.  
  58. NOTE: The following Caller*ID option flags are currently defined:
  59.  
  60.     0x0001    Caller*ID lock (login allowed only from known number)
  61.     0x0002    Fast logon
  62.  
  63.  
  64. Currently defined control flags are defined as follows:
  65.  
  66.     0x00000001     C0 - local session
  67.     0x00000002     C1 - paused output
  68.     0x00000004     C2 - linewrap
  69.     0x00000008     C3 - ANSI filter
  70.     0x00000010     C4 - graphics filter
  71.     0x00000020     C5 - remote enabled
  72.     0x00000040     C6 - protected mode (OS/2)
  73.  
  74. At session startup, control flags C1 through C4 are set from the user 
  75. record and C5 is set.  C0 and C6 are always constrained to reflect the 
  76. current situation and cannot be changed.  All other control flags are left 
  77. "as is" between sessions.  
  78.