Return to decache.3l CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / p_man / man3

Annotation of researchv10dc/630/man/src/p_man/man3/decache.3l, revision 1.1.1.1

1.1       root        1: .TH DECACHE 3L
                      2: .XE "decache()"
                      3: .SH NAME
                      4: decache \- remove the calling application from the Application cache
                      5: .SH SYNOPSIS
                      6: \f3int decache ( )\f1
                      7: 
                      8: .SH DESCRIPTION
                      9: The function
                     10: .I decache
                     11: lets the calling application remove itself from the Application
                     12: cache.
                     13: .PP
                     14: The function \fIdecache\fR frees up all the system's information used to
                     15: cache the application but 
                     16: does not delete the application itself; it just
                     17: returns the memory occupied by the application back to the application, so it can be
                     18: automatically freed when the application exits or is deleted.
                     19: .PP
                     20: The function \fIdecache\fR returns a 1 if the operation is successful, a 0
                     21: otherwise. Failure can be caused by not finding the calling application in the
                     22: Application cache, and by finding the cached application is currently in use, or
                     23: cannot be removed (i.e. see the discussion on \fBA_PERMANENT\fR flag in 
                     24: \fIcache(3L)\fR).
                     25: 
                     26: .SH EXAMPLE
                     27: The following program illustrates the relationship
                     28: between \fIdecache\fR and \fIcache(3L)\fR.
                     29: .PP
                     30: .RS 3
                     31: .nf
                     32: .ft CM
                     33: #include <dmd.h>
                     34: #include <object.h>
                     35: 
                     36: main ()
                     37: {
                     38:        register int n;
                     39: 
                     40:        lprintf ("Type c to cache\\n");
                     41:        lprintf ("Type u to uncache\\n");
                     42:        lprintf ("Type q to quit");
                     43:        request (KBD);
                     44:        while (wait(KBD)) {
                     45:                n = kbdchar();
                     46:                lprintf ("\\ncharacter typed: %c", n);
                     47:                if (n == 'c') {
                     48:                        n = cache ("test", 0);
                     49:                        lprintf (" -- cache returns %d", n);
                     50:                } 
                     51:                else if (n == 'u') {
                     52:                        n = decache ();
                     53:                        lprintf (" -- decache returns %d", n);
                     54:                }
                     55:                else if (n == 'q') 
                     56:                        break;
                     57:        }
                     58: }
                     59: .fi
                     60: .RE
                     61: 
                     62: .SH SEE ALSO
                     63: ucache(1),
                     64: cache(3L), cmdcache(3L).

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