Hi,

Includes is a patch and a t2lincks file which
implements the protection on parts in gpd or which I will
call EDIT MODE.  Notice that this is an `ALPHA PATCH' against
LINCKS Version 2.2 Patch Level 1.

I have not tested it extensivly, but I will do that during
the coming week and hoping on your help ;-). What might not 
work as expected is the W/w for hiding placeholders (<< ... >>),
bui the r/R/x/X as well W for getting read protection.

And what does this patch give you?
---------------------------------

On each item specificed in the STRUCTURE part of gpd
yoy can specificy for a given username (login) if 
(s)he is

  r  - allowed to see the item 
  w  - allowed to edit it and using insert-plural/deleta-plural
  x  - allowed to expand the item

  R  - not allowed to see the item (for overriding earlier 'r')
  W  - not allowed to edit the item
  X  - not allowed to expand it.

notice that the settings if not specificed is inherited from the
parent (like FORMAT) setting. Note:

1. Also, the normal indirection rules  (based on STRUCTURE should work). 
2. You can also use the name `%WORLD%' which means that the EDIT MODE
   is applicable to every one.
3. The EDIT MODE accumalted when we go from left to right and
   the sum of the setting is used.
4. Default is to allow rwx (e.g. as before) for everyone, 
   but if you add a `-DEDITMODE=0' to the EXTRA_DEFINES
   in Make.config/Make.config.in default will be that no
   access (RWX).
5. placeholder for object, e.g. <<item>> is only visible if
   w is set. 
6. insert-plural/delete-plural will only work if the closest
   plural (upwards) have 'w' bit set. 

A small example would be (I leave out the everything but the 
STRUCTURE part):

---------------------------
STRUCTURE
   document
      header abstract sections
   header
      title  authors
   sections
      title paragraphs sections
EDITMODE
   document
      rwx:%WORLD%:W;martin:XW;ralph,mark
   authors
      martin:X;ralph:w
---------------------------

And the natural interpretation is:

1) the world have by default rwx access - have read, write and expand
   access to whole document (we inherit topdown),

2) user `martin' have read and expansion right (we removed the
   write access from %WORLD%), but he is only allowed to read 
   the authors parts, no doing any expansion (the X).

3) user `ralph' and `mark' have only read (XW setting) access to the
   document, but `ralph' is allowed change the authors part (the w is
   added).

======================================================================
The archive includes to parts - one is a context diffs which you must
apply to the sources, and the second is a t2lincks file which updated 
the gpd `gpd' with the EDITMODE part. Proceeds as follows:

1. cut out the uuencoded archive (in tar.gz format) (i couldn't
   send is as shar since it contains control characters)

2. feed it to uudecode, gunzip and untar it by

     uunecode <file.uu
     gunzip editmode.tar.gz
     tar xvf editmode.tar
 
3. and you should have two files:

     editmode.patch   (49292 bytes)
     editmode.t2l     (375 bytes)

4. make a copy of source tree and then

5. move you your lincks-2.2.1 directory and do
      
     patch -p1 < editmode.patch

6. recompile (notice this patch fixes a few things more
   than editmode, e.g. t2lincks/dbpasswd/misc.c, i have
   extracted the echo/no-echo code into libshared.a)

   Also, if you would like to have default mode that nothing
   is accesible add the `-DEDITMODE=0' to the EXTRA_DEFINES
   in your Make.config (and Make.config.in, too possible).

7. Now, you need to updated the gpd `gpd' for, either 
   by using xlincks to make it look like (this only
   contains the changed/added parts): 

-----------------------------------------------
STRUCTURE
  editmode
     frame	
  gpd
     head date gpdmap structure access expansion format autolinks editmode
ACCESS
  editmode
    ATTR CONSTANT gpd_edit_mode = "EDITMODE"
----------------------------------------------

   or using `t2lincks' running as lincks user
	
t2lincks -u lincks -p <password> -f editmode.t2l <DB>

8. Now, you should be able to start playing with the protection,
   but as I told you this, is ALPHA quality software until it
   more thorugh tested.

Have fun!

msj
--
Martin Sj\"olin | http://www.ida.liu.se/labs/iislab/people/marsj
Department of Computer Science, LiTH, S-581 83 Link\"oping, SWEDEN 
phone : +46 13 28 24 10 | fax : +46 13 28 26 66 | e-mail: marsj@ida.liu.se