This repository has been archived on 2024-04-08. You can view files and clone it, but cannot push or open issues or pull requests.
deb-goldedplus/goldlib/gall/be_lock.h
2005-10-23 04:39:25 +00:00

119 lines
3.6 KiB
C

/*
BeLock.h - interface to Fido-style message bases lock BeOS library.
This code is written by Siarzhuk Zharski <imker@gmx.li> for free and
can be used for any purposes in any form without any warranties.
*/
/*
COMMENT: Many of Fidonet message bases uses file locks for theirs work in
concurrent environment. The Be Operating System has not such possibility.
Existing BeOS inplementations of locking allows to block only "nodes" from
any access. This blocking cannot prevent from some "entry" modification
attempts - for example, you can delete such file without problems or move
it to somewhere. The node is still locked but it is not that we wait for.
After long discussion on beos developer mail-lists I have not found usable
solution for this problem. That's why I decide to implement some alternative
locking technology. The key idea of my locking is using some BeOS-specific
kernel objects. At this time I found only single one to be accessible from
many processes - the BeOS kernel ports. See BeBook->Kernel Kit->Ports for
details. We can create port with some name and we can look for port with
such name in the system. Than, the locking algorithm is below:
1) Get the device and node IDs for file handle we going to lock:
fstat(file_handle, &stat_info);
2) Create the name for the port to be used as locking object:
sprintf(name, "FidoLock:%08X:%08X", stat_info.st_dev, stat_info.st_ino);
3) Look for existing port with this name:
pid = find_port(name);
if(pid == B_NAME_NOT_FOUND)
{
4) Create such port.
pid = create_port(1, name);
}
else
{
5) If such port exists - the file is locked - we must not touch it now -
say calling program about failed lock.
}
To unlock locked file - just delete the port
delete_port(pid);
This technique is also not perfect, but, in my opinion it is more safe than
node locking and more safe that work without any locking at al.
*/
#ifndef __BeLock_H_
#define __BeLock_H_
#include <OS.h>
#ifdef __cplusplus
extern "C" {
#endif //__cplusplus
/* be[os]_[f][un]lock() - acquires/releases file lock for file handle or stream
parameters:
file_handle - hanlde to file you want to [un]lock
file - opened stream for file you want to [un]lock
returns:
be_* - set of functions:
0 - on success
-1 - on fails. See errno for error code and B_* - codes below.
beos_* - set of functions:
B_OK
[0x00000000] - on success
other codes on error:
B_IO_ERROR (EIO)
[0x80000001] - input/output error.
For example fstat or fileno on file handles failed.
B_NAME_NOT_FOUND
[0x80000007] - port_name doesn't name an existing port.
Try to unlock non-existing filelock.
B_BAD_VALUE (EINVAL)
[0x80000005] - port's queue_length is too big or less than zero.
Error creating new port.
B_NO_MORE_PORTS
[0x80001201] - the system couldn't allocate another port.
Error creating new port.
B_BUSY (EBUSY)
[0x8000000E] - file is already locked - port exists.
B_BAD_PORT_ID
[0x80001200] - port doesn't identify an open port.
$Id$
*/
int be_lock(int file_handle);
int be_unlock(int file_handle);
int be_flock(FILE *file);
int be_funlock(FILE *file);
status_t beos_lock(int file_handle);
status_t beos_unlock(int file_handle);
status_t beos_flock(FILE *file);
status_t beos_funlock(FILE *file);
#ifdef __cplusplus
} //extern "C"
#endif //__cplusplus
#endif // __BeLock_H_