lustre/include/linux/lustre_idl.h

   1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
   2  * vim:expandtab:shiftwidth=8:tabstop=8:
   3  *
   4  *  Copyright (C) 2001 Cluster File Systems, Inc. <braam@clusterfs.com>
   5  *
   6  *   This file is part of Lustre, http://www.lustre.org.
   7  *
   8  *   Lustre is free software; you can redistribute it and/or
   9  *   modify it under the terms of version 2 of the GNU General Public
  10  *   License as published by the Free Software Foundation.
  11  *
  12  *   Lustre is distributed in the hope that it will be useful,
  13  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  *   GNU General Public License for more details.
  16  *
  17  *   You should have received a copy of the GNU General Public License
  18  *   along with Lustre; if not, write to the Free Software
  19  *   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  20  *
  21  * (Un)packing of OST requests
  22  */
  23
  24 #ifndef __LUSTRE_IDL_H__
  25 #define __LUSTRE_IDL_H__
  26 #ifdef __KERNEL__
  27 #include <linux/ioctl.h>
  28 #include <asm/types.h>
  29
  30 #include <linux/types.h>
  31 #else
  32 #define __KERNEL__
  33 #include <linux/list.h>
  34 #undef __KERNEL__
  35 #include <stdint.h>
  36 #endif
  37 /*
  38  * this file contains all data structures used in Lustre interfaces:
  39  * - obdo and obd_request records
  40  * - mds_request records
  41  * - ioctl's
  42  */
  43
  44
  45 /*
  46  *   OST requests: OBDO & OBD request records
  47  */
  48
  49 /* opcodes */
  50 #define OST_GETATTR    1
  51 #define OST_SETATTR    2
  52 #define OST_BRW        3
  53 #define OST_CREATE     4
  54 #define OST_DESTROY    5
  55 #define OST_GET_INFO   6
  56 #define OST_CONNECT    7
  57 #define OST_DISCONNECT 8
  58 #define OST_PUNCH      9
  59 #define OST_BRW_COMPLETE 10
  60
  61 /* packet types */
  62 #define OST_TYPE_REQ 1
  63 #define OST_TYPE_REP 2
  64 #define OST_TYPE_ERR 3
  65
  66 struct ptlreq_hdr {
  67         __u32 opc;
  68         __u32 xid;
  69         __u32 status;
  70         __u32 type;
  71 };
  72
  73 struct ptlrep_hdr {
  74         __u32 opc;
  75         __u32 xid;
  76         __u32 status;
  77         __u32 type;
  78 };
  79
  80 typedef uint64_t        obd_id;
  81 typedef uint64_t        obd_gr;
  82 typedef uint64_t        obd_time;
  83 typedef uint64_t        obd_size;
  84 typedef uint64_t        obd_off;
  85 typedef uint64_t        obd_blocks;
  86 typedef uint32_t        obd_blksize;
  87 typedef uint32_t        obd_mode;
  88 typedef uint32_t        obd_uid;
  89 typedef uint32_t        obd_gid;
  90 typedef uint32_t        obd_rdev;
  91 typedef uint32_t        obd_flag;
  92 typedef uint32_t        obd_count;
  93
  94 #define OBD_FL_INLINEDATA       (0x00000001UL)
  95 #define OBD_FL_OBDMDEXISTS      (0x00000002UL)
  96
  97 #define OBD_INLINESZ    60
  98 #define OBD_OBDMDSZ     60
  99 /* Note: 64-bit types are 64-bit aligned in structure */
 100 struct obdo {
 101         obd_id                  o_id;
 102         obd_gr                  o_gr;
 103         obd_time                o_atime;
 104         obd_time                o_mtime;
 105         obd_time                o_ctime;
 106         obd_size                o_size;
 107         obd_blocks              o_blocks;
 108         obd_blksize             o_blksize;
 109         obd_mode                o_mode;
 110         obd_uid                 o_uid;
 111         obd_gid                 o_gid;
 112         obd_flag                o_flags;
 113         obd_flag                o_obdflags;
 114         obd_count               o_nlink;
 115         obd_count               o_generation;
 116         obd_flag                o_valid;        /* hot fields in this obdo */
 117         char                    o_inline[OBD_INLINESZ];
 118         char                    o_obdmd[OBD_OBDMDSZ];
 119         struct list_head        o_list;
 120         struct obd_ops          *o_op;
 121 };
 122
 123 #define OBD_MD_FLALL    (~0UL)
 124 #define OBD_MD_FLID     (0x00000001UL)
 125 #define OBD_MD_FLATIME  (0x00000002UL)
 126 #define OBD_MD_FLMTIME  (0x00000004UL)
 127 #define OBD_MD_FLCTIME  (0x00000008UL)
 128 #define OBD_MD_FLSIZE   (0x00000010UL)
 129 #define OBD_MD_FLBLOCKS (0x00000020UL)
 130 #define OBD_MD_FLBLKSZ  (0x00000040UL)
 131 #define OBD_MD_FLMODE   (0x00000080UL)
 132 #define OBD_MD_FLTYPE   (0x00000100UL)
 133 #define OBD_MD_FLUID    (0x00000200UL)
 134 #define OBD_MD_FLGID    (0x00000400UL)
 135 #define OBD_MD_FLFLAGS  (0x00000800UL)
 136 #define OBD_MD_FLOBDFLG (0x00001000UL)
 137 #define OBD_MD_FLNLINK  (0x00002000UL)
 138 #define OBD_MD_FLGENER  (0x00004000UL)
 139 #define OBD_MD_FLINLINE (0x00008000UL)
 140 #define OBD_MD_FLOBDMD  (0x00010000UL)
 141 #define OBD_MD_FLOBJID  (0x00020000UL)
 142 #define OBD_MD_FLNOTOBD (~(OBD_MD_FLOBDMD | OBD_MD_FLOBDFLG | OBD_MD_FLBLOCKS))
 143
 144 /* request structure for OST's */
 145
 146 #define OST_REQ_HAS_OA1  0x1
 147
 148 struct ost_req {
 149         __u32   connid;
 150         __u32   cmd;
 151         struct  obdo oa;
 152         __u32   buflen1;
 153         __u32   buflen2;
 154 };
 155
 156 struct ost_rep {
 157         __u32   result;
 158         __u32   connid;
 159         struct  obdo oa;
 160         __u32   buflen1;
 161         __u32   buflen2;
 162 };
 163
 164 struct obd_ioobj {
 165         obd_id    ioo_id;
 166         obd_gr    ioo_gr;
 167         __u32     ioo_type;
 168         __u32     ioo_bufcnt;
 169 };
 170
 171
 172 /*
 173  *   MDS REQ RECORDS
 174  */
 175
 176
 177 #define MDS_TYPE_REQ 1
 178 #define MDS_TYPE_REP 2
 179 #define MDS_TYPE_ERR 3
 180
 181 #define MDS_GETATTR   1
 182 #define MDS_OPEN      2
 183 #define MDS_CLOSE     3
 184 #define MDS_REINT     4
 185 #define MDS_READPAGE  5
 186
 187 #define REINT_SETATTR 0
 188 #define REINT_CREATE  1
 189 #define REINT_LINK    2
 190 #define REINT_UNLINK  3
 191 #define REINT_RENAME  4
 192 #define REINT_MAX     4
 193
 194 struct ll_fid {
 195         __u64 id;
 196         __u32 generation;
 197         __u32 f_type;
 198 };
 199
 200 struct niobuf {
 201         __u64 addr;
 202         __u64 offset;
 203         __u32 len;
 204         __u32 flags;
 205         void *page;
 206 };
 207
 208 struct mds_req {
 209         struct ll_fid        fid1;
 210         struct ll_fid        fid2;
 211         __u32                       namelen;
 212         __u32                       tgtlen;
 213         __u32                       opcode;
 214         __u32                       valid;
 215         __u32                       mode;
 216         __u32                       uid;
 217         __u32                       gid;
 218         __u64                       size;
 219         __u32                       mtime;
 220         __u32                       ctime;
 221         __u32                       atime;
 222         __u32                       flags;
 223         __u32                       major;
 224         __u32                       minor;
 225         __u32                       ino;
 226         __u32                       nlink;
 227         __u32                       generation;
 228         __u64                       objid;
 229 };
 230
 231 struct mds_rep {
 232         struct ll_fid               fid1;
 233         struct ll_fid               fid2;
 234         __u32                       namelen;
 235         __u32                       tgtlen;
 236         __u32                       valid;
 237         __u32                       mode;
 238         __u32                       uid;
 239         __u32                       gid;
 240         __u64                       size;
 241         __u32                       mtime;
 242         __u32                       ctime;
 243         __u32                       atime;
 244         __u32                       flags;
 245         __u32                       major;
 246         __u32                       minor;
 247         __u32                       ino;
 248         __u32                       nlink;
 249         __u32                       generation;
 250         __u64                       objid;
 251 };
 252
 253 /* MDS update records */
 254 struct mds_update_record_hdr {
 255         __u32 ur_reclen;
 256         __u32 ur_opcode;
 257 };
 258
 259 struct mds_rec_setattr {
 260         __u32           sa_reclen;
 261         __u32           sa_opcode;
 262         struct ll_fid   sa_fid;
 263         __u32           sa_valid;
 264         __u32           sa_mode;
 265         __u32           sa_uid;
 266         __u32           sa_gid;
 267         __u64           sa_size;
 268         __u64           sa_atime;
 269         __u64           sa_mtime;
 270         __u64           sa_ctime;
 271         __u32           sa_attr_flags;
 272 };
 273
 274 struct mds_rec_create {
 275         __u32           cr_reclen;
 276         __u32           cr_opcode;
 277         struct ll_fid   cr_fid;
 278         __u32           cr_uid;
 279         __u32           cr_gid;
 280         __u64           cr_time;
 281         __u32           cr_mode;
 282         /* overloaded: id for create, tgtlen for symlink, rdev for mknod */
 283         __u64           cr_id;
 284         __u32           cr_namelen;
 285         __u32           cr_tgtlen;
 286         /* name here */
 287         /* symlink target here */
 288 };
 289
 290 struct mds_rec_link {
 291         __u32           lk_reclen;
 292         __u32           lk_opcode;
 293         struct ll_fid   lk_fid1;
 294         struct ll_fid   lk_fid2;
 295         __u32           lk_namelen;
 296 };
 297
 298 struct mds_rec_unlink {
 299         __u32           ul_reclen;
 300         __u32           ul_opcode;
 301         struct ll_fid   ul_fid1;
 302         __u32           ul_namelen;
 303 };
 304
 305 struct mds_rec_rename {
 306         __u32           rn_reclen;
 307         __u32           rn_opcode;
 308         struct ll_fid   rn_fid1;
 309         struct ll_fid   rn_fid2;
 310         __u32           rn_namelen;
 311         __u32           rn_tgtlen;
 312 };
 313
 314 #ifdef __KERNEL__
 315
 316 static inline void ll_ino2fid(struct ll_fid *fid, ino_t ino, __u32 generation, int type)
 317 {
 318         fid->id = HTON__u64((__u64)ino);
 319         fid->generation = HTON__u32(generation);
 320         fid->f_type = HTON__u32(type);
 321 }
 322
 323 static inline void ll_inode2fid(struct ll_fid *fid, struct inode *inode)
 324 {
 325         fid->id = HTON__u64((__u64)inode->i_ino);
 326         fid->generation = HTON__u32(inode->i_generation);
 327         fid->f_type = HTON__u32(inode->i_mode & S_IFMT);
 328 }
 329
 330 #endif
 331
 332 /*
 333  *   OBD IOCTLS
 334  */
 335
 336
 337 #define OBD_IOCTL_VERSION 0x00010001
 338
 339 struct obd_ioctl_data {
 340         uint32_t ioc_len;
 341         uint32_t ioc_version;
 342         uint32_t ioc_conn1;
 343         uint32_t ioc_conn2;
 344         struct obdo ioc_obdo1;
 345         struct obdo ioc_obdo2;
 346         obd_size         ioc_count;
 347         obd_off          ioc_offset;
 348         uint32_t         ioc_dev;
 349
 350         /* buffers the kernel will treat as user pointers */
 351         uint32_t ioc_plen1;
 352         char    *ioc_pbuf1;
 353         uint32_t ioc_plen2;
 354         char    *ioc_pbuf2;
 355
 356         /* two inline buffers */
 357         uint32_t ioc_inllen1;
 358         char    *ioc_inlbuf1;
 359         uint32_t ioc_inllen2;
 360         char    *ioc_inlbuf2;
 361
 362         char    ioc_bulk[0];
 363 };
 364
 365 struct obd_ioctl_hdr {
 366         uint32_t ioc_len;
 367         uint32_t ioc_version;
 368 };
 369
 370 static inline int obd_ioctl_packlen(struct obd_ioctl_data *data)
 371 {
 372         int len = sizeof(struct obd_ioctl_data);
 373         len += size_round(data->ioc_inllen1);
 374         len += size_round(data->ioc_inllen2);
 375         return len;
 376 }
 377
 378 static inline int obd_ioctl_is_invalid(struct obd_ioctl_data *data)
 379 {
 380         if (data->ioc_len > (1<<30)) {
 381                 printk("OBD ioctl: ioc_len larger than 1<<30\n");
 382                 return 1;
 383         }
 384         if (data->ioc_inllen1 > (1<<30)) {
 385                 printk("OBD ioctl: ioc_inllen1 larger than 1<<30\n");
 386                 return 1;
 387         }
 388         if (data->ioc_inllen2 > (1<<30)) {
 389                 printk("OBD ioctl: ioc_inllen2 larger than 1<<30\n");
 390                 return 1;
 391         }
 392         if (data->ioc_inlbuf1 && !data->ioc_inllen1) {
 393                 printk("OBD ioctl: inlbuf1 pointer but 0 length\n");
 394                 return 1;
 395         }
 396         if (data->ioc_inlbuf2 && !data->ioc_inllen2) {
 397                 printk("OBD ioctl: inlbuf2 pointer but 0 length\n");
 398                 return 1;
 399         }
 400         if (data->ioc_pbuf1 && !data->ioc_plen1) {
 401                 printk("OBD ioctl: pbuf1 pointer but 0 length\n");
 402                 return 1;
 403         }
 404         if (data->ioc_pbuf2 && !data->ioc_plen2) {
 405                 printk("OBD ioctl: pbuf2 pointer but 0 length\n");
 406                 return 1;
 407         }
 408         if (obd_ioctl_packlen(data) != data->ioc_len ) {
 409                 printk("OBD ioctl: packlen exceeds ioc_len\n");
 410                 return 1;
 411         }
 412         if (data->ioc_inllen1 &&
 413             data->ioc_bulk[data->ioc_inllen1 - 1] != '\0') {
 414                 printk("OBD ioctl: inlbuf1 not 0 terminated\n");
 415                 return 1;
 416         }
 417         if (data->ioc_inllen2 &&
 418             data->ioc_bulk[size_round(data->ioc_inllen1) + data->ioc_inllen2 - 1] != '\0') {
 419                 printk("OBD ioctl: inlbuf2 not 0 terminated\n");
 420                 return 1;
 421         }
 422         return 0;
 423 }
 424
 425 #ifndef __KERNEL__
 426 static inline int obd_ioctl_pack(struct obd_ioctl_data *data, char **pbuf, int max)
 427 {
 428         char *ptr;
 429         struct obd_ioctl_data *overlay;
 430         data->ioc_len = obd_ioctl_packlen(data);
 431         data->ioc_version = OBD_IOCTL_VERSION;
 432
 433         if (*pbuf && obd_ioctl_packlen(data) > max)
 434                 return 1;
 435         if (*pbuf == NULL) {
 436                 *pbuf = malloc(data->ioc_len);
 437         }
 438         if (!*pbuf)
 439                 return 1;
 440         overlay = (struct obd_ioctl_data *)*pbuf;
 441         memcpy(*pbuf, data, sizeof(*data));
 442
 443         ptr = overlay->ioc_bulk;
 444         if (data->ioc_inlbuf1)
 445                 LOGL(data->ioc_inlbuf1, data->ioc_inllen1, ptr);
 446         if (data->ioc_inlbuf2)
 447                 LOGL(data->ioc_inlbuf2, data->ioc_inllen2, ptr);
 448         if (obd_ioctl_is_invalid(overlay))
 449                 return 1;
 450
 451         return 0;
 452 }
 453 #else
 454
 455
 456 /* buffer MUST be at least the size of obd_ioctl_hdr */
 457 static inline int obd_ioctl_getdata(char *buf, char *end, void *arg)
 458 {
 459         struct obd_ioctl_hdr *hdr;
 460         struct obd_ioctl_data *data;
 461         int err;
 462         ENTRY;
 463
 464         hdr = (struct obd_ioctl_hdr *)buf;
 465         data = (struct obd_ioctl_data *)buf;
 466
 467         err = copy_from_user(buf, (void *)arg, sizeof(*hdr));
 468         if ( err ) {
 469                 EXIT;
 470                 return err;
 471         }
 472
 473         if (hdr->ioc_version != OBD_IOCTL_VERSION) {
 474                 printk("OBD: version mismatch kernel vs application\n");
 475                 return -EINVAL;
 476         }
 477
 478         if (hdr->ioc_len + buf >= end) {
 479                 printk("OBD: user buffer exceeds kernel buffer\n");
 480                 return -EINVAL;
 481         }
 482
 483
 484         if (hdr->ioc_len < sizeof(struct obd_ioctl_data)) {
 485                 printk("OBD: user buffer too small for ioctl\n");
 486                 return -EINVAL;
 487         }
 488
 489         err = copy_from_user(buf, (void *)arg, hdr->ioc_len);
 490         if ( err ) {
 491                 EXIT;
 492                 return err;
 493         }
 494
 495         if (obd_ioctl_is_invalid(data)) {
 496                 printk("OBD: ioctl not correctly formatted\n");
 497                 return -EINVAL;
 498         }
 499
 500         if (data->ioc_inllen1) {
 501                 data->ioc_inlbuf1 = &data->ioc_bulk[0];
 502         }
 503
 504         if (data->ioc_inllen2) {
 505                 data->ioc_inlbuf2 = &data->ioc_bulk[0] + size_round(data->ioc_inllen1);
 506         }
 507
 508         EXIT;
 509         return 0;
 510 }
 511 #endif
 512
 513
 514 #define OBD_IOC_CREATE                 _IOR ('f',  3, long)
 515 #define OBD_IOC_SETUP                  _IOW ('f',  4, long)
 516 #define OBD_IOC_CLEANUP                _IO  ('f',  5      )
 517 #define OBD_IOC_DESTROY                _IOW ('f',  6, long)
 518 #define OBD_IOC_PREALLOCATE            _IOWR('f',  7, long)
 519 #define OBD_IOC_DEC_USE_COUNT          _IO  ('f',  8      )
 520 #define OBD_IOC_SETATTR                _IOW ('f',  9, long)
 521 #define OBD_IOC_GETATTR                _IOR ('f', 10, long)
 522 #define OBD_IOC_READ                   _IOWR('f', 11, long)
 523 #define OBD_IOC_WRITE                  _IOWR('f', 12, long)
 524 #define OBD_IOC_CONNECT                _IOR ('f', 13, long)
 525 #define OBD_IOC_DISCONNECT             _IOW ('f', 14, long)
 526 #define OBD_IOC_STATFS                 _IOWR('f', 15, long)
 527 #define OBD_IOC_SYNC                   _IOR ('f', 16, long)
 528 #define OBD_IOC_READ2                  _IOWR('f', 17, long)
 529 #define OBD_IOC_FORMAT                 _IOWR('f', 18, long)
 530 #define OBD_IOC_PARTITION              _IOWR('f', 19, long)
 531 #define OBD_IOC_ATTACH                 _IOWR('f', 20, long)
 532 #define OBD_IOC_DETACH                 _IOWR('f', 21, long)
 533 #define OBD_IOC_COPY                   _IOWR('f', 22, long)
 534 #define OBD_IOC_MIGR                   _IOWR('f', 23, long)
 535 #define OBD_IOC_PUNCH                  _IOWR('f', 24, long)
 536 #define OBD_IOC_DEVICE                 _IOWR('f', 25, long)
 537 #define OBD_IOC_MODULE_DEBUG           _IOWR('f', 26, long)
 538
 539 #define OBD_IOC_DEC_FS_USE_COUNT       _IO  ('f', 32      )
 540
 541
 542 /* GENERAL THINGS */
 543 union ptl_rep {
 544         struct mds_rep *mds;
 545         struct ost_rep *ost;
 546 };
 547
 548 union ptl_req {
 549         struct mds_req *mds;
 550         struct ost_req *ost;
 551 };
 552
 553
 554 #endif