Return to insert.nr CVS log

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

Annotation of 43BSD/ingres/doc/access/insert.nr, revision 1.1

1.1     ! root        1: .th INSERT AM 9/13/77
        !             2: .sh NAME
        !             3: insert - add a new tuple to a relation
        !             4: .sh SYNOPSIS
        !             5: .nf
        !             6: insert(d, tid, tuple, checkdups)
        !             7: struct descriptor      *d;
        !             8: struct tup_id          *tid;
        !             9: char                   tuple[MAXTUP];
        !            10: int                    checkdups;
        !            11: .fi
        !            12: .sh DESCRIPTION
        !            13: INSERT will insert the offered tuple into the "correct"
        !            14: position in the relation.  TID will be set to the TID which is
        !            15: assigned to the tuple.
        !            16: Normally INSERT should be called with CHECKDUPS = 1 which will
        !            17: cause INSERT to check for a duplicate tuple prior to making the
        !            18: insertion.  In certain special cases when dealing with INGRES
        !            19: system relations (i.e. RELATION, ATTRIBUTE, etc.),
        !            20: the calling program may know that a check for duplicates is not 
        !            21: necessary and may call INSERT with CHECKDUPS = 0.
        !            22: If the relation is stored as a heap (D->RELSPEC = 5),
        !            23: checkdups will be ignored
        !            24: and assumed to be false.
        !            25: .sh DIAGNOSTICS
        !            26: .nf
        !            27: AMFIND_ERR -- unidentifiable storage structure
        !            28: AMWRITE_ERR -- write error
        !            29: AMREAD_ERR -- read error
        !            30: 0 -- success
        !            31: 1 -- a duplicate of TUPLE was found
        !            32: Tid will be set to the tuple id of the duplicate.
        !            33: .fi
        !            34: .sh "TRACE FLAGS"
        !            35: 24.0
        !            36: .sh "SEE ALSO"
        !            37: closer, findbest, openr, put_tuple

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