mirror of
https://github.com/minio/minio.git
synced 2024-12-25 22:55:54 -05:00
9cdd981ce7
additionally also add a new ForceUnlock API, to allow forcibly unlocking locks if possible.
83 lines
2.9 KiB
Go
83 lines
2.9 KiB
Go
/*
|
|
* Minio Cloud Storage, (C) 2016 Minio, Inc.
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package dsync
|
|
|
|
import "context"
|
|
|
|
// LockArgs is minimal required values for any dsync compatible lock operation.
|
|
type LockArgs struct {
|
|
// Unique ID of lock/unlock request.
|
|
UID string
|
|
|
|
// Resources contains single or multiple entries to be locked/unlocked.
|
|
Resources []string
|
|
|
|
// Source contains the line number, function and file name of the code
|
|
// on the client node that requested the lock.
|
|
Source string
|
|
|
|
// Owner represents unique ID for this instance, an owner who originally requested
|
|
// the locked resource, useful primarily in figuring our stale locks.
|
|
Owner string
|
|
|
|
// Quorum represents the expected quorum for this lock type.
|
|
Quorum int
|
|
}
|
|
|
|
// NetLocker is dsync compatible locker interface.
|
|
type NetLocker interface {
|
|
// Do read lock for given LockArgs. It should return
|
|
// * a boolean to indicate success/failure of the operation
|
|
// * an error on failure of lock request operation.
|
|
RLock(ctx context.Context, args LockArgs) (bool, error)
|
|
|
|
// Do write lock for given LockArgs. It should return
|
|
// * a boolean to indicate success/failure of the operation
|
|
// * an error on failure of lock request operation.
|
|
Lock(ctx context.Context, args LockArgs) (bool, error)
|
|
|
|
// Do read unlock for given LockArgs. It should return
|
|
// * a boolean to indicate success/failure of the operation
|
|
// * an error on failure of unlock request operation.
|
|
RUnlock(args LockArgs) (bool, error)
|
|
|
|
// Do write unlock for given LockArgs. It should return
|
|
// * a boolean to indicate success/failure of the operation
|
|
// * an error on failure of unlock request operation.
|
|
Unlock(args LockArgs) (bool, error)
|
|
|
|
// Expired returns if current lock args has expired.
|
|
Expired(ctx context.Context, args LockArgs) (bool, error)
|
|
|
|
// Unlock (read/write) forcefully for given LockArgs. It should return
|
|
// * a boolean to indicate success/failure of the operation
|
|
// * an error on failure of unlock request operation.
|
|
ForceUnlock(ctx context.Context, args LockArgs) (bool, error)
|
|
|
|
// Returns underlying endpoint of this lock client instance.
|
|
String() string
|
|
|
|
// Close closes any underlying connection to the service endpoint
|
|
Close() error
|
|
|
|
// Is the underlying connection online? (is always true for any local lockers)
|
|
IsOnline() bool
|
|
|
|
// Is the underlying locker local to this server?
|
|
IsLocal() bool
|
|
}
|