1SERRNO(3)                  Castor Library Functions                  SERRNO(3)
2
3
4

NAME

6       serrno - LCG internal error variable
7
8

SYNOPSIS

10       #include <serrno.h>
11
12       extern int serrno;
13       extern char *sstrerror(int serrno_value );
14       extern void sperror(char * message );
15
16

DESCRIPTION

18       The  serrno  variable  is the LCG's equivalent to system error variable
19       errno. This variable, accessible only  trough  LCG  API's  and  related
20       functions below is guaranteed to be thread-safe.
21       The  serrno variable is divided into common values and per package val‐
22       ues, that are:
23
24              COPYTAPE
25
26              DB                 - Database
27
28              MSG                - Message daemon
29
30              NS                 - Name server
31
32              RFIO               - Remote File I/O
33
34              RTCOPY             - Remote Tape Copy
35
36              STAGE              - Stager
37
38              SYSREQ
39
40              TAPE               - Tape operations
41
42              VMGR               - Volume Manager
43
44              VDQM               - Volume and Drive Queue Manager
45
46              RMC                - Remote SCSI Media Changer Server
47
48              MON                - Monitoring
49
50              UPV                - User Privilege
51
52              DPM                - Disk Pool Manager
53
54              SECURITY
55
56

COMMON ERRORS

58       The following error values might be returned by any package:
59
60       SENOSHOST          (1001) Host unknown
61
62       SENOSSERV          (1002) Service unknown
63
64       SENOTRFILE         (1003) Not a remote file
65
66       SETIMEDOUT         (1004) Has timed out
67
68       SEBADFFORM         (1005) Bad fortran format specifier
69
70       SEBADFOPT          (1006) Bad fortran option specifier
71
72       SEINCFOPT          (1007) Incompatible fortran options
73
74       SENAMETOOLONG      (1008) File name too long
75
76       SENOCONFIG         (1009) Can't open configuration file
77
78       SEBADVERSION       (1010) Version ID mismatch
79
80       SEUBUF2SMALL       (1011) User buffer too small
81
82       SEMSGINVRNO        (1012) Invalid reply number
83
84       SEUMSG2LONG        (1013) User message too long
85
86       SEENTRYNFND        (1014) Entry not found
87
88       SEINTERNAL         (1015) Internal error
89
90       SECONNDROP         (1016) Connection closed by rem. end
91
92       SEBADIFNAM         (1017) Can't get interface name
93
94       SECOMERR           (1018) Communication error
95
96       SENOMAPDB          (1019) Can't open mapping database
97
98       SENOMAPFND         (1020) No user mapping
99
100       SERTYEXHAUST       (1021) Retry count exhausted
101
102       SEOPNOTSUP         (1022) Operation not supported
103
104       SEWOULDBLOCK       (1023) Resource temporarily unavailable
105
106       SEINPROGRESS       (1024) Operation now in progress
107
108       SECTHREADINIT      (1025) Cthread initialization error
109
110       SECTHREADERR       (1026) Thread interface call error
111
112       SESYSERR           (1027) System error
113
114       SEADNSINIT         (1028) adns_init() error
115
116       SEADNSSUBMIT       (1029) adns_submit() error
117
118       SEADNS             (1030) adns resolving error
119
120       SEADNSTOOMANY      (1031) adns returned more than one entry
121
122       SENOTADMIN         (1032) requestor is not administrator
123
124       SEUSERUNKN         (1033) User unknown
125
126       SEDUPKEY           (1034) Duplicate key value
127
128       SEENTRYEXISTS      (1035) The entry already exists
129
130       SEGROUPUNKN        (1036) Group Unknown
131
132       SECHECKSUM         (1037) Bad checksum
133
134       SELOOP             (1038) Too many symbolic links encountered
135
136

COPYTAPE ERRORS

138       None yet
139
140

DB ERRORS

142       The following error values are returned only by the database package:
143
144       EDB_A_ESESSION     (1201) Cdb api           : invalid session
145
146       EDB_A_EDB          (1202) Cdb api           : invalid db
147
148       EDB_A_EINVAL       (1203) Cdb api           : invalid value
149
150       EDB_A_RESHOST      (1204) Cdb api           : host res error
151
152       EDB_A_TOOMUCH      (1205) Cdb api           : data size rejected
153
154       EDB_AS_SOCKET      (1206) Cdb api    system : socket() error
155
156       EDB_AS_SOCKOPT     (1207) Cdb api    system : [set/get]sockopt() error
157
158       EDB_AS_MALLOC      (1208) Cdb api    system : malloc() error
159
160       EDB_A_NOERROR      (1209) Cdb api           : no last error
161
162       EDB_A_IEINVAL      (1200) Cdb api           : interface invalid value
163
164       EDB_AS_BIND        (1201) Cdb api           : bind() error
165
166       EDB_AS_LISTEN      (1202) Cdb api           : listen() error
167
168       EDB_AS_GETSOCKNAME (1203) Cdb api         : getsockname() error
169
170       EDB_AS_ACCEPT      (1204) Cdb api           : accept() error
171
172       EDB_AS_GETPEERNAME (1205) Cdb api        : getpeername() error
173
174       EDB_A_WHOISIT      (1206) Cdb api        : Connection from bad host
175
176       EDB_D_EINVAL       (1220) Cdb daemon        : invalid value
177
178       EDB_D_EAGAIN       (1221) Cdb daemon        : yet done
179
180       EDB_D_AUTH         (1222) Cdb daemon        : unauthorized
181
182       EDB_D_LOGIN        (1223) Cdb daemon        : login refused
183
184       EDB_D_PWDCORR      (1224) Cdb daemon        : pwd file corrupted
185
186       EDB_D_ANA          (1225) Cdb daemon        : db analysis error
187
188       EDB_D_HASHSIZE     (1226) Cdb daemon        : bad hash size
189
190       EDB_D_UNKNOWN      (1227) Cdb daemon        : unkn. db/table/key
191
192       EDB_D_NOLOCK       (1228) Cdb daemon        : lock is required
193
194       EDB_D_CORRUPT      (1229) Cdb daemon        : probably corrupted
195
196       EDB_D_TOOMUCH      (1230) Cdb daemon        : data size rejected
197
198       EDB_D_ENOENT       (1231) Cdb daemon        : no entry
199
200       EDB_D_ETYPE        (1232) Cdb daemon        : unknown member type
201
202       EDB_D_EVALUE       (1233) Cdb daemon        : unknown member val
203
204       EDB_D_NULLVALUE    (1234) Cdb daemon        : null member value
205
206       EDB_D_LOCK         (1235) Cdb daemon        : cannot gain lock
207
208       EDB_D_FREE         (1236) Cdb daemon        : unsafe free attempt
209
210       EDB_D_SHUTDOWN     (1237) Cdb daemon        : shutdown in progress
211
212       EDB_D_DEADLOCK     (1238) Cdb daemon        : shutdown in progress
213
214       EDB_D_EXIST        (1239) Cdb daemon        : yet exists
215
216       EDB_D_NOSPC        (1240) Cdb daemon        : no more space
217
218       EDB_D_DUMPEND      (1241) Cdb daemon        : end of dump
219
220       EDB_D_UNIQUE       (1242) Cdb daemon        : uniqued key yet exist
221
222       EDB_D_LISTEND      (1243) Cdb daemon        : end of list
223
224       EDB_D_NOTDUMP      (1244) Cdb daemon        : not in dump mode
225
226       EDB_D_DNSCHECK     (1245) Cdb daemon        : double DNS check error
227
228       EDB_D_REJECTED     (1246) Cdb daemon        : Connection rejected  (not
229                          authorised)
230
231       EDB_D_INIT         (1247) Cdb daemon        : init in progress
232
233       EDB_D_INCONST      (1248)  Cdb  daemon         :  Cdb  daemon         :
234                          inconsistent request (unstop and no  previous  stop,
235                          unfreeze and no previous freeze)
236
237       EDB_D_FREEHASHSIZE (1249) Cdb daemon        : bad free hash size
238
239       EDB_DS_MALLOC      (1250) Cdb daemon system : malloc() error
240
241       EDB_DS_CALLOC      (1251) Cdb daemon system : calloc() error
242
243       EDB_DS_REALLOC     (1252) Cdb daemon system : realloc() error
244
245       EDB_DS_OPEN        (1253) Cdb daemon system : open() error
246
247       EDB_DS_FSTAT       (1254) Cdb daemon system : fstat() error
248
249       EDB_DS_LSEEK       (1255) Cdb daemon system : lseek() error
250
251       EDB_DS_READ        (1256) Cdb daemon system : read() error
252
253       EDB_DS_WRITE       (1257) Cdb daemon system : write() error
254
255       EDB_DS_RENAME      (1258) Cdb daemon system : rename() error
256
257       EDB_DS_FTRUNC      (1259) Cdb daemon system : ftruncate() error
258
259       EDB_DS_TMPNAM      (1260) Cdb daemon system : tmpnam() error
260
261       EDB_DS_FCNTL       (1261) Cdb daemon system : fcntl() error
262
263       EDB_DS_MKDIR       (1262) Cdb daemon system : mkdir() error
264
265       EDB_DS_TIMES       (1263) Cdb daemon system : times() error
266
267       EDB_DS_SYSCONF     (1264) Cdb daemon system : sysconf() err/unav
268
269       EDB_DS_GETHOSTNAME (1265) Cdb daemon system : gethostname() error
270
271       EDB_DS_GETPEERNAME (1266) Cdb daemon system : getpeername() error
272
273       EDB_DS_INET_NTOA   (1267) Cdb daemon system : getpeername() error
274
275       EDB_DS_REMOVE      (1268) Cdb daemon system : remove() error
276
277       EDB_DS_SIGACTION   (1269) Cdb daemon system : sigaction() error
278
279       EDB_DS_GETSOCKNAME (1270) Cdb daemon system : getsockname() error
280
281       EDB_DS_BIND        (1271) Cdb daemon system : bind() error
282
283       EDB_DS_LISTEN      (1272) Cdb daemon system : listen() error
284
285       EDB_DS_CONNECT     (1273) Cdb daemon system : connect() error
286
287       EDB_DS_SOCKET      (1274) Cdb daemon system : socket() error
288
289       EDB_DS_SOCKOPT     (1275) Cdb daemon system : [set/get]sockopt() error
290
291       EDB_D_RESHOST      (1276) Cdb daemon     : host res error
292
293       EDB_D_REQSIZE      (1277) Cdb daemon     : request too big
294
295       EDB_C_EINVAL       (1280) Cdb config        : invalid value
296
297       EDB_C_ENOENT       (1281) Cdb config        : configuration error
298
299       EDB_C_TOOMUCH      (1282) Cdb config        : conf. size rejected
300
301       EDB_CS_GETHOSTNAME (1283) Cdb config system : gethostname() error
302
303       EDB_NOMOREDB       (1290) Cdb : nomoredb (the API retries automatically
304                          in such a case so you should never  see  this  error
305                          number)
306
307

MSG ERRORS

309       The following error values are returned only by the message package:
310
311       EMSMSGU2REP        (1301) msg daemon unable to reply
312
313       EMSMSGSYERR        (1302) msg daemon system error
314
315       EMSNOPERM          (1303) Permission denied
316
317

NS ERRORS

319       The  following  error values are returned only by the name server pack‐
320       age:
321
322       ENSNACT            (1401) name  server  not  active  or  service  being
323                          drained
324
325

RFIO ERRORS

327       The  following  error  values  are returned only by the remote file I/O
328       package:
329
330       ERFNORCODE         (1501) RFIO communication error
331
332       ERFHOSTREFUSED     (1502) RFIO rejected connect attempt
333
334       ERFXHOST           (1503) Cross-host link (rename())
335
336       ERFPROTONOTSUP     (1504) RFIO protocol not supported
337
338

RTCOPY ERRORS

340       The following error values are returned only by the  remote  tape  copy
341       package:
342
343       ERTTMSERR          (1601) TMS call failed
344
345       ERTBLKSKPD         (1602) Blocks were skipped in file
346
347       ERTTPE_LSZ         (1603) Blocks skipped and file truncated
348
349       ERTMNYPARY         (1604) Too many skipped blocks
350
351       ERTLIMBYSZ         (1605) File limited by size
352
353       ERTUSINTR          (1606) Request interrupted by user
354
355       ERTOPINTR          (1607) Request interrupted by operator
356
357       ERTNOTCLIST        (1608) Request list is not circular
358
359       ERTBADREQ          (1609) Bad request structure
360
361

STAGE ERRORS

363       The following error values are returned only by the stager package:
364
365       ESTCLEARED         (1701) aborted by stageclr
366
367       ESTENOUGHF         (1702) enough free space
368
369       ESTLNKNCR          (1703) symbolic link not created
370
371       ESTLNKNSUP         (1704) symbolic link not supported
372
373       ESTNACT            (1705) Stager not active
374
375       ESTGROUP           (1706) Your group is invalid
376
377       ESTGRPUSER         (1707) No GRPUSER in configuration
378
379       ESTUSER            (1708) Invalid user
380
381       ESTHSMHOST         (1709) HSM HOST not specified
382
383       ESTTMSCHECK        (1710) tmscheck error
384
385       ESTLINKNAME        (1711) User link name processing error
386
387       ESTWRITABLE        (1712) User path in a non-writable directory
388
389       ESTKILLED          (1713) aborted by kill
390
391       ESTMEM             (1714) request too long (api)
392
393       ESTCONF            (1715) stage configuration error
394
395

SYSREQ ERRORS

397       The following error value is returned only by the sysreq package:
398
399       ESQTMSNOTACT       (1801) TMS not active
400
401

TAPE ERRORS

403       The following error values are returned only by the tape package:
404
405       ETDNP              (1901) daemon not available
406
407       ETSYS              (1902) system error
408
409       ETPRM              (1903) bad parameter
410
411       ETRSV              (1904) reserv already issued
412
413       ETNDV              (1905) too many drives requested
414
415       ETIDG              (1906) invalid device group name
416
417       ETNRS              (1907) reserv not done
418
419       ETIDN              (1908) no drive with requested characteristics
420
421       ETLBL              (1909) bad label structure
422
423       ETFSQ              (1910) bad file sequence number
424
425       ETINTR             (1911) interrupted by user
426
427       ETEOV              (1912) EOV found in multivolume set
428
429       ETRLSP             (1913) release pending
430
431       ETBLANK            (1914) blank tape
432
433       ETCOMPA            (1915) compatibility problem
434
435       ETHWERR            (1916) device malfunction
436
437       ETPARIT            (1917) parity error
438
439       ETUNREC            (1918) unrecoverable media error
440
441       ETNOSNS            (1919) no sense
442
443       ETRSLT             (1920) reselect server
444
445       ETVBSY             (1921) volume busy or inaccessible
446
447       ETDCA              (1922) drive currently assigned
448
449       ETNRDY             (1923) drive not ready
450
451       ETABSENT           (1924) volume absent
452
453       ETARCH             (1925) volume archived
454
455       ETHELD             (1926) volume held or disabled
456
457       ETNXPD             (1927) file not expired
458
459       ETOPAB             (1928) operator cancel
460
461       ETVUNKN            (1929) volume unknown
462
463       ETWLBL             (1930) wrong label type
464
465       ETWPROT            (1931) cartridge write protected
466
467       ETWVSN             (1932) wrong vsn
468
469       ETBADMIR           (1933) Tape has a bad MIR
470
471

VMGR ERRORS

473       The  following  error  values  are  returned only by the volume manager
474       package:
475
476       EVMGRNACT          (2001) volume manager not active  or  service  being
477                          drained
478
479

VDQM ERRORS

481       The  following  error  values are returned only by the volume and drive
482       queue manager package:
483
484       EVQSYERR           (2101) Failed system call
485
486       EVQINCONSIST       (2102) Internal DB inconsistency
487
488       EVQREPLICA         (2103) DB replication failed
489
490       EVQNOVOL           (2104) No volume request queued
491
492       EVQNODRV           (2105) No free drive available
493
494       EVQNOSVOL          (2106) Specified vol. req. not found
495
496       EVQNOSDRV          (2107) Specified drv. req. not found
497
498       EVQALREADY         (2108) Specified vol. req. already exists
499
500       EVQUNNOTUP         (2109) Unit not up
501
502       EVQBADSTAT         (2110) Bad unit status request
503
504       EVQBADID           (2111) Incorrect vol.req or job ID
505
506       EVQBADJOBID        (2112) Incorrect job ID
507
508       EVQNOTASS          (2113) Unit not assigned
509
510       EVQBADVOLID        (2114) Attempt to mount with wrong VOLID
511
512       EVQREQASS          (2115) Attempt to delete an assigned req
513
514       EVQDGNINVL         (2116) Vol. req. for non-existing DGN
515
516       EVQPIPEFULL        (2117) Replication pipe is full
517
518       EVQHOLD            (2118) Server is held
519
520       EVQEOQREACHED      (2119) End of query reached
521
522

RMC ERRORS

524       The following error values are returned only by the Remote  SCSI  media
525       changer server package:
526
527       ERMCNACT           (2201)  Remote  SCSI media changer server not active
528                          or service being drained
529
530       ERMCRBTERR         (2202) Remote SCSI media changer error
531
532       ERMCUNREC          (2203) Remote SCSI media changer unrec. error
533
534       ERMCSLOWR          (2204) Remote SCSI media changer error (slow retry)
535
536       ERMCFASTR          (2205) Remote SCSI media changer error (fast retry)
537
538       ERMCDFORCE         (2206) Remote  SCSI  media  changer  error  (demount
539                          force)
540
541       ERMCDDOWN          (2207) Remote SCSI media changer error (drive down)
542
543       ERMCOMSGN          (2208) Remote SCSI media changer error (ops message)
544
545       ERMCOMSGS          (2209)  Remote SCSI media changer error (ops message
546                          + retry)
547
548       ERMCOMSGR          (2210) Remote SCSI media changer error (ops  message
549                          + wait)
550
551       ERMCUNLOAD         (2211)  Remote  SCSI  media  changer error (unload +
552                          demount)
553
554

MON ERRORS

556       The following error values are returned only by the Monitoring package:
557
558       EMON_SYSTEM        (2301) System error
559
560       EMON_NO_HOST       (2302) Monitor Host not specified
561
562       EMON_NO_PORT       (2303) Monitor Port not specified
563
564       EMON_NO_CLIENTPORT (2304) No port for client requests  defined  in  the
565                          configuration
566
567

UPV ERRORS

569       The following error values are returned only by the User Privilege Val‐
570       idation package:
571
572       ECUPVNACT          (2401) UPV not active or service being drained
573
574

DPM ERRORS

576       The following error values are returned only by the Disk  Pool  Manager
577       package:
578
579       EDPMNACT           (2601) DPM not active or service being drained
580
581

SECURITY ERRORS

583       The following error values are returned only by the Security package:
584
585       ESEC_SYSTEM        (2701) System error in the security package
586
587       ESEC_BAD_CREDENTIALS
588                          (2702) Bad credentials
589
590       ESEC_NO_CONTEXT    (2703) Could not establish context
591
592       ESEC_BAD_MAGIC     (2704) Bad magic number
593
594       ESEC_NO_USER       (2705) Could not map username to uid/gid
595
596       ESEC_NO_PRINC      (2706) Could not map principal to username
597
598       ESEC_NO_SECMECH    (2707) Could not load security mechanism
599
600       ESEC_CTX_NOT_INITIALIZED
601                          (2708) Context not initialized
602
603       ESEC_PROTNOTSUPP   (2709) Security protocol not supported
604
605       ESEC_NO_SVC_NAME   (2710) Service name not set
606
607       ESEC_NO_SVC_TYPE   (2711) Service type not set
608
609       ESEC_NO_SECPROT    (2712) Could not lookup security protocol
610
611       ESEC_BAD_CSEC_VERSION
612                          (2713) Csec incompatability
613
614       ESEC_BAD_PEER_RESP (2714) Unexpected response from peer
615
616

AUTHOR

618       LCG Grid Deployment Team
619
620
621
622LCG                      $Date: 2006/01/27 09:52:14 $                SERRNO(3)
Impressum