Return to getshput.3 CVS log

Up to [Research Unix] / researchv10dc / man / manx

Annotation of researchv10dc/man/manx/getshput.3, revision 1.1.1.1

1.1       root        1: .TH GETSHPUT 3 SHARE
                      2: .SH NAME
                      3: getshput \- read, modify, and write shares file entry
                      4: .SH SYNOPSIS
                      5: .B "#include <shares.h>"
                      6: .br
                      7: .sp
                      8: .B "unsigned long getshput(lp, func)"
                      9: .br
                     10: .B "struct lnode * lp;"
                     11: .br
                     12: .B "unsigned long (*func)();"
                     13: .SH DESCRIPTION
                     14: .I Getshput
                     15: finds the shares entry with the same uid as
                     16: .I lp\->l_uid
                     17: and reads it into an internal
                     18: .I lnode
                     19: structure.
                     20: The function pointed to by
                     21: .I func
                     22: is then called with two arguments,
                     23: the first pointing to the original
                     24: .I lnode
                     25: structure,
                     26: and the second pointing to the internal
                     27: .I lnode
                     28: structure.
                     29: If
                     30: .I func
                     31: returns with a value other than 0
                     32: the (presumably modified) second structure is written back to the shares file,
                     33: with the ``extime'' field in the shares record filled with the value returned by
                     34: .IR func .
                     35: Otherwise
                     36: .I getshput
                     37: simply returns.
                     38: .I Getshput
                     39: returns the value returned by
                     40: .IR func .
                     41: .SH "SEE ALSO"
                     42: closeshares(3),
                     43: getshares(3),
                     44: openshares(3),
                     45: putshares(3),
                     46: sharesfile(3).
                     47: .SH DIAGNOSTICS
                     48: .I Getshput
                     49: returns 0
                     50: if the entry can't be modified.

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