rmc_mnt.man 1.81 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
.\" Copyright (C) 2002 by CERN/IT/PDP/DM
.\" All rights reserved
.\"
.TH RMC_MNT 3 "$Date: 2013/11/18 16:21:00 $" CASTOR "rmc Library Functions"
.SH NAME
rmc_mnt \- send a request to the Remote Media Changer daemon to have a volume mounted
.SH SYNOPSIS
.B #include <sys/types.h>
.br
\fB#include "rmc_api.h"\fR
.sp
12
.BI "int \fBrmc_mnt\f[](const char *const \fIvid\f[], const char *const \fIdrive\f[]);
13
14
.SH DESCRIPTION
.B rmc_mnt
15
asks the remote media-changer daemon to mount the volume
16
17
.I vid
on the drive specified by
18
.IR drive .
19
20
21
22
23
.TP
.I vid
is the volume visual identifier.
It must be at most six characters long.
.TP
24
.I drive
25
specifies the drive in one of the following three forms corresponding to the three supported drive-loader types, namely acs, manual and smc:
26
27
.RS
.TP
28
acs@rmc_host,ACS_NUMBER,LSM_NUMBER,PANEL_NUMBER,TRANSPORT_NUMBER
29
30
31
.TP
manual
.TP
32
smc@rmc_host,drive_ordinal
33
34
35
36
.RE
.LP
This function requires TP_SYSTEM privilege in the Cupv database.
.SH RETURN VALUE
Steven Murray's avatar
Steven Murray committed
37
38
39
40
41
42
43
44
45
46
47
48
.TP
.B 0
The mount operation was successful.
.TP
.B 1
The mount operations is manual and the rmc_mnt() function has therefore not
taken any further action.
.TP
.B -1
The mount operation has failed and both
.B errno
and
49
.B serrno
Steven Murray's avatar
Steven Murray committed
50
51
have been set appropriately.

52
.SH ERRORS
53
.TP 1.8i
54
55
56
.B EINVAL
If either \fIvid\f[] or \fIdrive\f[] are passed a NULL pointer.
.TP
57
58
59
60
.B SECOMERR
Communication error.
.TP
.B ERMCUNREC
61
Unknown host or invalid drive or requester does not have
62
63
64
65
66
67
68
TP_SYSTEM privilege in the Cupv database.
.TP
.B ERMCFASTR
Unit attention.
.TP
.B ERMCOMSGR
Hardware error or Medium Removal Prevented.
69
70
.TP
.B ERMCUKNLDRTYPE
71
Unknown drive-loader type.
72
73
74
75
76
77
78
79
80
81
82
83
.TP
.B ERMCVIDTOOLONG
VID is too long.
.TP
.B ERMCPARSERMCHOST
Failed to parse RMC host.
.TP
.B ERMCPARSEACSDRV
Failed to parse ACS drive id.
.TP
.B SEINTERNAL
Internal error.
84
85
.SH AUTHOR
\fBCASTOR\fP Team <castor.support@cern.ch>