repio.h

Go to the documentation of this file.

/* BLURB gpl
 
                           Coda File System
                              Release 6
 
          Copyright (c) 1987-2003 Carnegie Mellon University
                  Additional copyrights listed below
 
This  code  is  distributed "AS IS" without warranty of any kind under
the terms of the GNU General Public Licence Version 2, as shown in the
file  LICENSE.  The  technical and financial  contributors to Coda are
listed in the file CREDITS.
 
                        Additional copyrights
                           none currently
 
#*/
 
/* Created:
    M. Satyanarayanan
    June 1989
 
*/
 
/*  Directory repair data structures and routines
 
    A directory repair involves a list of individual repair operations.
    This list is constructed on the client and executed on the server.
    (In automated resolution, gets constructed on server)
    The repair is executed within a transaction at the server.
    struct repair defines one step in the repair.
    It should really be a union type but this is painful in C.
*/
 
#define REPAIR_MAX 5 /* Max no of integer parms for a repair entry */
#ifndef MAXNAMELEN
/* Max len of pathname component, should this be defined somewhere
 * in /usr/include/sys? */
#define MAXNAMELEN 255
#endif
 
/* Realm of localcache objects should be 0xffffffff */
#ifndef IS_LOCAL
#define IS_LOCAL(realm) (realm == 0xffffffff)
//#define IS_LOCAL(realm) (!strcmp("localhost", realm))
#endif
 
struct repair {
    unsigned opcode; /* values defined below */
    char name[MAXNAMELEN]; /* overloaded; null-terminated */
    char newname[MAXNAMELEN]; /* used only by rename */
    unsigned parms[REPAIR_MAX]; /* overloaded */
};
 
/* Repair opcodes */
 
#define REPAIR_OPBASE 174320 /* random */
 
/* Creation:
    repair.name  specifies object name
    repair.parms[0..2] specify FID to be associated with this name
*/
#define REPAIR_CREATEF REPAIR_OPBASE + 1 /* Create file */
#define REPAIR_CREATED REPAIR_OPBASE + 2 /* Create directory */
#define REPAIR_CREATES REPAIR_OPBASE + 3 /* Create sym link */
#define REPAIR_CREATEL REPAIR_OPBASE + 4 /* Create (hard) link */
 
/* Remove opcodes:
    repair.name specifies object name
    repair.parms ignored
*/
#define REPAIR_REMOVEFSL REPAIR_OPBASE + 5 /* Remove file or (hard) link */
#define REPAIR_REMOVED REPAIR_OPBASE + 6 /* Remove dir */
 
/* ACL mods:
    repair.name gives name of user in acl
    repair.parms[0] specifies rights
*/
/* REPAIR_DELACL is removed; repair.parms[0] = 0 means delete entry */
#define REPAIR_SETACL REPAIR_OPBASE + 7 /* Set rights */
#define REPAIR_SETNACL REPAIR_OPBASE + 8 /* Set negative rights */
 
/* Status mods:
    repair.name is ignored
    repair.parms[0] gives new value
*/
#define REPAIR_SETMODE REPAIR_OPBASE + 9
#define REPAIR_SETOWNER \
    REPAIR_OPBASE + 10 /* Have to be a sys administrator for this */
#define REPAIR_SETMTIME REPAIR_OPBASE + 11
 
/* Next replica:
    repair.name is the name of the server
       repair.parms[0] is a hex number, giving read-write volid of this replica
 
    Seen only in ASCII input files typed by users
*/
#define REPAIR_REPLICA REPAIR_OPBASE + 12
 
#define REPAIR_RENAME REPAIR_OPBASE + 13 /* mv object */
 
/* The structure below is the header for the repairs to be made to one replica.
   An array of such structures can describe the repairs to all replicas.
   The number of replicas cannot be static, since disconnected operation can
   produce one conflicting replica per client.
*/
 
struct listhdr {
    ViceFid replicaFid; /* unique fid of this replica */
    unsigned int repairCount; /* number of entries in array repairList[] */
    struct repair
        *repairList; /* pointer to array of repair entries for this replica */
};
 
/* I/O routines */
int repair_putdfile(char *fname, int replicaCount, struct listhdr *replicaList);
int repair_getdfile(char *fname, int *replicaCount,
                    struct listhdr **replicaList);
int repair_getdfile(int infd, int *replicaCount, struct listhdr **replicaList);
int repair_parseline(char *line, struct repair *rs);
int repair_parsefile(char *fname, int *hdcount, struct listhdr **hdarray);
void repair_printline(struct repair *rs, FILE *ff);
void repair_printfile(char *fname);