Contents   Index

File Primitives

The following file primitives are provided:

• FILE *p_open(char *name,char *mode,int tb)
  returns a valid filepointer (FILE *) or NULL.
• int p_close(FILE *fp,int etb)
  returns SUCCESS, TIMEOUT, FAILURE, or NOT_OK.
• int p_lock(char *name,char *mode,int etb)
  returns OK or NOT_OK.
• int p_unlock(char *name,char *mode)
  returns OK or NOT_OK.
• int p_stat(char *name,long *mt,long *ct,long *cct,long *ret, long *wet)
  returns CACHED with mt, ct, cct, ret, and wet set, NOT_CACHED, or NOT_OK.
• int p_remove(char *name)
  returns OK or NOT_OK

Errors are reported by the pso_errno variable. If no errors are encountered pso_errno is set to PSO_ENOERROR. An error message corresponding to the given error number can be written using the p_perror procedure, see Section 5.7.2.

Legal values of mode are:

• For reading (only): "r", "rb".
• For (re-)writing: "w", "wb", "w+", "w+b".
• For reading and writing (i.e., updating): "r+", "r+b".
• For appending: "a", "ab", "a+", "a+b".

Note: The additional b (for binary) makes no difference in a UNIX environment. All strings containing either r, w, or a are initially accepted by $\mathcal{P}$$e$$\mathcal{S}$$t$$\mathcal{O}$ but if they are illegal (i.e., not one of those listed above) with respect to the standard ANSI-C mode used in fopen they might fail after all.

Time bounds, tb or etb, are given in whole minutes. Expiration time bounds, etb's, less than zero are treated as zeros.

  Contents   Index