0b22fac399523574e75165eba39ab553ebc9ea40
[openafs.git] / src / uss / uss_common.h
1 /*
2  * Copyright 2000, International Business Machines Corporation and others.
3  * All Rights Reserved.
4  * 
5  * This software has been released under the terms of the IBM Public
6  * License.  For details, see the LICENSE file in the top-level source
7  * directory or online at http://www.openafs.org/dl/license10.html
8  */
9
10 /*
11  *      Common definitions & global variables for the AFS user
12  *      account facility.
13  *
14  */
15
16 #ifndef _USS_COMMON_H_
17 #define _USS_COMMON_H_ 1
18
19 /*
20  * --------------------- Required definitions ---------------------
21  */
22 #include <afs/param.h>          /*Basic system configuration stuff*/
23 #include <sys/param.h>          /*Ditto*/
24 #include <stdio.h>              /*I/O stuff*/
25 #include <afs/afsutil.h>
26 #include <errno.h>
27
28 /*
29  * --------------------- Exported definitions ---------------------
30  */
31
32 /*
33  * Should we use static declarations or malloc()s?
34  */
35
36 #define uss_QUIET 0
37 #define uss_VERBOSE 1
38
39 #define uss_MAX_ARG               25
40 #define uss_MAX_ARG_SIZE          50
41 #define uss_MAX_ENTRY            400
42 #define uss_PATH_SIZE           AFSDIR_PATH_MAX
43 #define uss_MAX_SIZE            2048
44
45 #define uss_DEFAULT_PASSWORD "changeme"
46
47 /*
48  * Capacities for the exported variables.
49  */
50 #define uss_UserLen               8
51 #define uss_UidLen                8
52 #define uss_ServerLen            64
53 #define uss_PartitionLen         16
54 #define uss_MountPointLen       300
55 #define uss_RealNameLen         100
56 #define uss_PwdLen               16
57 #define uss_PwdPathLen          300
58 #define uss_PwdFormatLen        100
59 #define uss_RestoreDirLen       300
60 #define uss_VolumeLen           300
61 #define uss_DirPoolLen          300
62
63 #if !defined(AFS_LINUX20_ENV) && !defined(AFS_DARWIN_ENV) && !defined(AFS_FBSD_ENV)
64 extern char *sys_errlist[];
65 #endif
66
67 /*
68  * We have to chain every directory that we make in order to be
69  * able to come back in the reverse order and remove creator's
70  * access to each directory.
71  */
72 struct uss_subdir {
73     struct uss_subdir *previous;        /*Back ptr*/
74     char *path;                         /*Pathname to dir*/
75     char *finalACL;                     /*Final ACL for dir*/
76 };
77
78 /*
79  * This is extracted from afsint.h, which can't be included because it
80  * redefines some stuff from kauth.h.
81  */
82 struct uss_VolumeStatus {
83     afs_int32 Vid;
84     afs_int32 ParentId;
85     char Online;
86     char InService;
87     char Blessed;
88     char NeedsSalvage;
89     afs_int32 Type;
90     afs_int32 MinQuota;
91     afs_int32 MaxQuota;
92     afs_int32 BlocksInUse;
93     afs_int32 PartBlocksAvail;
94     afs_int32 PartMaxBlocks;
95 };
96
97 typedef struct uss_VolumeStatus uss_VolumeStatus_t;
98
99
100 /*
101  * ---------------------- Exported variables ----------------------
102  */
103 extern char uss_User[];                 /*User's account name*/
104 extern char uss_Uid[];                  /*User's uid*/
105 extern char uss_Server[];               /*FileServer hosting user's volume*/
106 extern char uss_Partition[];            /*FileServer partition for above*/
107 extern char uss_MountPoint[];           /*Mountpoint for user's volume*/
108 extern char uss_RealName[];             /*User's full name*/
109 extern char uss_Pwd[];                  /*User's password*/
110 extern char uss_PwdPath[];              /*Current pathname to password file*/
111 extern char uss_PwdPath_Saved[];        /*Saved pathname to password file*/
112 extern char uss_PwdFormat[];            /*Current password entry format*/
113 extern char uss_PwdFormat_Saved[];      /*Saved password entry format*/
114 extern char uss_RestoreDir[];           /*Current directory for restore info*/
115 extern char uss_RestoreDir_Saved[];     /*Saved directory for restore info*/
116 extern char uss_Auto[];                 /*Current choice of AUTO value*/
117 extern char uss_Var[][uss_MAX_ARG_SIZE]; /*$1, $2, ... command variables*/
118 extern int uss_VarMax;                  /*Largest index in above*/
119 extern char uss_Volume[];               /*Name of user's volume*/
120 extern afs_int32 uss_VolumeID;          /*Numerical volume ID*/
121 extern afs_int32 uss_ServerID;          /*Numerical server ID*/
122 extern afs_int32 uss_PartitionID;               /*Numerical partition ID*/
123 extern char uss_DirPool[][uss_DirPoolLen]; /*List of all acceptable subdirs*/
124
125 extern int uss_NumGroups;               /*Number of $AUTO entries*/
126 extern int uss_SaveVolume;              /*Save current user volume?*/
127 extern int uss_SaveVolume_Saved;        /*Saved value of above*/
128 extern int uss_DryRun;                  /*Is this a dry run?*/
129 extern int uss_Overwrite;               /*Overwrite user files?*/
130 extern int uss_SkipKaserver;            /*Ignore calls to Kaserver*/
131 extern int uss_OverwriteThisOne;        /*Overwrite on this pass?*/
132 extern char uss_Administrator[];        /*Name of admin account*/
133 extern char uss_AccountCreator[];       /*Principal running this program*/
134 extern afs_int32 uss_DesiredUID;                /*UID to assign the user*/
135 extern afs_int32 uss_Expires;                /*Password lifetime*/
136 extern char uss_Cell[];                 /*Cell in which account lives*/
137 extern char uss_ConfDir[];              /*Config directory*/
138 extern int uss_verbose;                 /*Should we be verbose?*/
139 extern int uss_ignoreFlag;              /*Ignore yyparse errors?*/
140 extern char uss_whoami[];               /*Program name used*/
141 extern int uss_syntax_err;              /*YACC syntax error?*/
142 extern struct uss_subdir *uss_currentDir;  /*Current directory*/
143
144
145 /*
146  * ------------------------ Exported functions  -----------------------
147  */
148 extern void uss_common_Init();
149     /*
150      * Summary:
151      *    Set up various common uss variables, especially the saved
152      *    ones.
153      *
154      * Args:
155      *    None.
156      *
157      * Returns:
158      *    Nothing.
159      */
160
161 extern void uss_common_Reset();
162     /*
163      * Summary:
164      *    Reset some common uss variables to their idle or
165      *    saved states.
166      *
167      * Args:
168      *    None.
169      *
170      * Returns:
171      *    Nothing.
172      */
173
174 extern char *uss_common_FieldCp();
175     /*
176      * Summary:
177      *    Copy a ``field'', as terminated by the given separator, or
178      *    up to a certain specified length.  Gripe if there was an
179      *    overflow.
180      *
181      * Args:
182      *    char *a_to       : Destination of the copy.
183      *    char *a_from     : Source of the copy.
184      *    char a_separator : Separator character to look for.
185      *    int a_maxChars   : Max chars to copy.
186      *    int *a_overflowP : Was there an overflow?
187      *
188      * Returns:
189      *    Ptr to the next location to read from.
190      */
191
192 #endif /* _USS_COMMON_H_ */