1 /* AFS Volume Location Service client interface 2 * 3 * Copyright (C) 2002, 2007 Red Hat, Inc. All Rights Reserved. 4 * Written by David Howells (dhowells@redhat.com) 5 * 6 * This program is free software; you can redistribute it and/or 7 * modify it under the terms of the GNU General Public License 8 * as published by the Free Software Foundation; either version 9 * 2 of the License, or (at your option) any later version. 10 */ 11 12 #ifndef AFS_VL_H 13 #define AFS_VL_H 14 15 #include "afs.h" 16 17 #define AFS_VL_PORT 7003 /* volume location service port */ 18 #define VL_SERVICE 52 /* RxRPC service ID for the Volume Location service */ 19 #define YFS_VL_SERVICE 2503 /* Service ID for AuriStor upgraded VL service */ 20 21 enum AFSVL_Operations { 22 VLGETENTRYBYID = 503, /* AFS Get VLDB entry by ID */ 23 VLGETENTRYBYNAME = 504, /* AFS Get VLDB entry by name */ 24 VLPROBE = 514, /* AFS probe VL service */ 25 VLGETENTRYBYIDU = 526, /* AFS Get VLDB entry by ID (UUID-variant) */ 26 VLGETENTRYBYNAMEU = 527, /* AFS Get VLDB entry by name (UUID-variant) */ 27 VLGETADDRSU = 533, /* AFS Get addrs for fileserver */ 28 YVLGETENDPOINTS = 64002, /* YFS Get endpoints for file/volume server */ 29 VLGETCAPABILITIES = 65537, /* AFS Get server capabilities */ 30 }; 31 32 enum AFSVL_Errors { 33 AFSVL_IDEXIST = 363520, /* Volume Id entry exists in vl database */ 34 AFSVL_IO = 363521, /* I/O related error */ 35 AFSVL_NAMEEXIST = 363522, /* Volume name entry exists in vl database */ 36 AFSVL_CREATEFAIL = 363523, /* Internal creation failure */ 37 AFSVL_NOENT = 363524, /* No such entry */ 38 AFSVL_EMPTY = 363525, /* Vl database is empty */ 39 AFSVL_ENTDELETED = 363526, /* Entry is deleted (soft delete) */ 40 AFSVL_BADNAME = 363527, /* Volume name is illegal */ 41 AFSVL_BADINDEX = 363528, /* Index is out of range */ 42 AFSVL_BADVOLTYPE = 363529, /* Bad volume type */ 43 AFSVL_BADSERVER = 363530, /* Illegal server number (out of range) */ 44 AFSVL_BADPARTITION = 363531, /* Bad partition number */ 45 AFSVL_REPSFULL = 363532, /* Run out of space for Replication sites */ 46 AFSVL_NOREPSERVER = 363533, /* No such Replication server site exists */ 47 AFSVL_DUPREPSERVER = 363534, /* Replication site already exists */ 48 AFSVL_RWNOTFOUND = 363535, /* Parent R/W entry not found */ 49 AFSVL_BADREFCOUNT = 363536, /* Illegal Reference Count number */ 50 AFSVL_SIZEEXCEEDED = 363537, /* Vl size for attributes exceeded */ 51 AFSVL_BADENTRY = 363538, /* Bad incoming vl entry */ 52 AFSVL_BADVOLIDBUMP = 363539, /* Illegal max volid increment */ 53 AFSVL_IDALREADYHASHED = 363540, /* RO/BACK id already hashed */ 54 AFSVL_ENTRYLOCKED = 363541, /* Vl entry is already locked */ 55 AFSVL_BADVOLOPER = 363542, /* Bad volume operation code */ 56 AFSVL_BADRELLOCKTYPE = 363543, /* Bad release lock type */ 57 AFSVL_RERELEASE = 363544, /* Status report: last release was aborted */ 58 AFSVL_BADSERVERFLAG = 363545, /* Invalid replication site server flag */ 59 AFSVL_PERM = 363546, /* No permission access */ 60 AFSVL_NOMEM = 363547, /* malloc/realloc failed to alloc enough memory */ 61 }; 62 63 enum { 64 YFS_SERVER_INDEX = 0, 65 YFS_SERVER_UUID = 1, 66 YFS_SERVER_ENDPOINT = 2, 67 }; 68 69 enum { 70 YFS_ENDPOINT_IPV4 = 0, 71 YFS_ENDPOINT_IPV6 = 1, 72 }; 73 74 #define YFS_MAXENDPOINTS 16 75 76 /* 77 * maps to "struct vldbentry" in vvl-spec.pdf 78 */ 79 struct afs_vldbentry { 80 char name[65]; /* name of volume (with NUL char) */ 81 afs_voltype_t type; /* volume type */ 82 unsigned num_servers; /* num servers that hold instances of this vol */ 83 unsigned clone_id; /* cloning ID */ 84 85 unsigned flags; 86 #define AFS_VLF_RWEXISTS 0x1000 /* R/W volume exists */ 87 #define AFS_VLF_ROEXISTS 0x2000 /* R/O volume exists */ 88 #define AFS_VLF_BACKEXISTS 0x4000 /* backup volume exists */ 89 90 afs_volid_t volume_ids[3]; /* volume IDs */ 91 92 struct { 93 struct in_addr addr; /* server address */ 94 unsigned partition; /* partition ID on this server */ 95 unsigned flags; /* server specific flags */ 96 #define AFS_VLSF_NEWREPSITE 0x0001 /* Ignore all 'non-new' servers */ 97 #define AFS_VLSF_ROVOL 0x0002 /* this server holds a R/O instance of the volume */ 98 #define AFS_VLSF_RWVOL 0x0004 /* this server holds a R/W instance of the volume */ 99 #define AFS_VLSF_BACKVOL 0x0008 /* this server holds a backup instance of the volume */ 100 #define AFS_VLSF_UUID 0x0010 /* This server is referred to by its UUID */ 101 #define AFS_VLSF_DONTUSE 0x0020 /* This server ref should be ignored */ 102 } servers[8]; 103 }; 104 105 #define AFS_VLDB_MAXNAMELEN 65 106 107 108 struct afs_ListAddrByAttributes__xdr { 109 __be32 Mask; 110 #define AFS_VLADDR_IPADDR 0x1 /* Match by ->ipaddr */ 111 #define AFS_VLADDR_INDEX 0x2 /* Match by ->index */ 112 #define AFS_VLADDR_UUID 0x4 /* Match by ->uuid */ 113 __be32 ipaddr; 114 __be32 index; 115 __be32 spare; 116 struct afs_uuid__xdr uuid; 117 }; 118 119 struct afs_uvldbentry__xdr { 120 __be32 name[AFS_VLDB_MAXNAMELEN]; 121 __be32 nServers; 122 struct afs_uuid__xdr serverNumber[AFS_NMAXNSERVERS]; 123 __be32 serverUnique[AFS_NMAXNSERVERS]; 124 __be32 serverPartition[AFS_NMAXNSERVERS]; 125 __be32 serverFlags[AFS_NMAXNSERVERS]; 126 __be32 volumeId[AFS_MAXTYPES]; 127 __be32 cloneId; 128 __be32 flags; 129 __be32 spares1; 130 __be32 spares2; 131 __be32 spares3; 132 __be32 spares4; 133 __be32 spares5; 134 __be32 spares6; 135 __be32 spares7; 136 __be32 spares8; 137 __be32 spares9; 138 }; 139 140 struct afs_address_list { 141 refcount_t usage; 142 unsigned int version; 143 unsigned int nr_addrs; 144 struct sockaddr_rxrpc addrs[]; 145 }; 146 147 extern void afs_put_address_list(struct afs_address_list *alist); 148 149 #endif /* AFS_VL_H */ 150