Return to openr.nr CVS log

Up to [CSRG BSD Unix] / 43BSD / ingres / doc / access

Annotation of 43BSD/ingres/doc/access/openr.nr, revision 1.1.1.1

1.1       root        1: .th OPENR AM 9/13/77
                      2: .sh NAME
                      3: openr - open a relation
                      4: .sh SYNOPSIS
                      5: .nf
                      6: openr(d, mode, uniqid)
                      7: struct descriptor      *d;
                      8: int                    mode;
                      9: char                   uniqid[MAXNAME];
                     10: .fi
                     11: .sh DESCRIPTION
                     12: OPENR is used to open a relation and set up a descriptor
                     13: for the relation.
                     14: The descriptor is used by all of the
                     15: access method functions and contains a template of the relation.
                     16: The parameter UNIQID is the unique relation id which is to
                     17: be opened.
                     18: OPENR will search the relation relation and find the tuple which describes
                     19: the desired relation.  
                     20: OPENR will first search for a relation named by UNIQID and
                     21: owned by the current user.
                     22: If tha fails,
                     23: OPENR will search for a relation with the same name
                     24: but owned by the data base administrator.
                     25: The calling program may determine who the relation owner is by
                     26: examining D->RELOWNER in the returned descriptor.
                     27: OPENR will also search the attribute
                     28: relation and gather information necessary to create a template
                     29: of the relation.
                     30: Finally, OPENR will do the UNIX open on the
                     31: file which contains the relation.
                     32: .sp
                     33: If MODE equals 0, the relation will be opened as a read only file,
                     34: if MODE equals 1 or 2, the relation will be opened as a read/write file.
                     35: If MODE is specified as -1 then the relation will be looked
                     36: up in the relation relation and that part
                     37: of the descriptor will be filled in.
                     38: However, the relation will not
                     39: be opened and the attribute template will not be set in the
                     40: descriptor.
                     41: OPENR may be called with MODE set to -2,
                     42: which will fill in the attribute template and open the relation as read only.
                     43: Calling OPENR twice, first with MODE set to -1, the second time
                     44: with MODE set to -2,
                     45: is equivalent to calling OPENR once with MODE set to 0.
                     46: Using mode -3 is the same as mode
                     47: -2 except that the relation is open for writing.
                     48: Modes -4 and -5 both assume the relation has been
                     49: opened previously and the descriptor is complete.
                     50: Mode -4 will reopen the unix file for reading,
                     51: and mode -5 will reopen the unix file for writing.
                     52: .sh DIAGNOSTICS
                     53: .nf
                     54: AMOPNVIEW_ERR -- attempt to open a view for reading or writing.
                     55: AMFIND_ERR -- unidentifiable storage structure for relation or attribute
                     56: relations
                     57: AMNOATTS_ERR -- error in filling attribute template
                     58: AMNOFILE_ERR -- no UNIX file corresponding to relation
                     59: AMWRITE_ERR -- pageflush failure
                     60: AMREAD_ERR -- get_page failure
                     61: 0 -- success
                     62: 1 -- no such relation
                     63: .fi
                     64: .sh "TRACE FLAGS"
                     65: 21.0, 21.4
                     66: .sh "SEE ALSO"
                     67: closer, get_attuples, get_reltuple, inpcloser, noclose

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.