Link to the shared memory segment whose name is share_name and
associate it with the specified file or record buffer.
The shared memory segment must have already have been created by another
program, using the
create_shared_memory() function. The
record buffer should have exactly the same structure as the one
specified in the program that created the shared memory segment. If it
does not, the results are undefined.
The values of share_name and options must match those used by
the process that created the shared memory segment. See
for full details of these arguments.
record_id | file_id
The identifier of the record structure
(!record) or file
to be linked to the shared memory segment.
The return value from the function must be stored in an i4 type
field. If the function was successful, the return value is non-zero and
is used to identify this shared memory segment in calls to other shared
A return value of zero means that the function failed. The error number
is stored in sys.Errno. The normal reason
for failure is that the shared memory segment has not been created.