/* SPDX-License-Identifier: MIT */
/*
 * VirtualBox Shared Folders: host interface definition.
 *
 * Copyright (C) 2006-2018 Oracle Corporation
 */

#ifndef SHFL_HOSTINTF_H
#define SHFL_HOSTINTF_H

#include <linux/vbox_vmmdev_types.h>

/* The max in/out buffer size for a FN_READ or FN_WRITE call */
#define SHFL_MAX_RW_COUNT           (16 * SZ_1M)

/*
 * Structures shared between guest and the service
 * can be relocated and use offsets to point to variable
 * length parts.
 *
 * Shared folders protocol works with handles.
 * Before doing any action on a file system object,
 * one have to obtain the object handle via a SHFL_FN_CREATE
 * request. A handle must be closed with SHFL_FN_CLOSE.
 */

enum {
        SHFL_FN_QUERY_MAPPINGS = 1,     /* Query mappings changes. */
        SHFL_FN_QUERY_MAP_NAME = 2,     /* Query map name. */
        SHFL_FN_CREATE = 3,             /* Open/create object. */
        SHFL_FN_CLOSE = 4,              /* Close object handle. */
        SHFL_FN_READ = 5,               /* Read object content. */
        SHFL_FN_WRITE = 6,              /* Write new object content. */
        SHFL_FN_LOCK = 7,               /* Lock/unlock a range in the object. */
        SHFL_FN_LIST = 8,               /* List object content. */
        SHFL_FN_INFORMATION = 9,        /* Query/set object information. */
        /* Note function number 10 is not used! */
        SHFL_FN_REMOVE = 11,            /* Remove object */
        SHFL_FN_MAP_FOLDER_OLD = 12,    /* Map folder (legacy) */
        SHFL_FN_UNMAP_FOLDER = 13,      /* Unmap folder */
        SHFL_FN_RENAME = 14,            /* Rename object */
        SHFL_FN_FLUSH = 15,             /* Flush file */
        SHFL_FN_SET_UTF8 = 16,          /* Select UTF8 filename encoding */
        SHFL_FN_MAP_FOLDER = 17,        /* Map folder */
        SHFL_FN_READLINK = 18,          /* Read symlink dest (as of VBox 4.0) */
        SHFL_FN_SYMLINK = 19,           /* Create symlink (as of VBox 4.0) */
        SHFL_FN_SET_SYMLINKS = 20,      /* Ask host to show symlinks (4.0+) */
};

/* Root handles for a mapping are of type u32, Root handles are unique. */
#define SHFL_ROOT_NIL           UINT_MAX

/* Shared folders handle for an opened object are of type u64. */
#define SHFL_HANDLE_NIL         ULLONG_MAX

/* Hardcoded maximum length (in chars) of a shared folder name. */
#define SHFL_MAX_LEN         (256)
/* Hardcoded maximum number of shared folder mapping available to the guest. */
#define SHFL_MAX_MAPPINGS    (64)

/** Shared folder string buffer structure. */
struct shfl_string {
        /** Allocated size of the string member in bytes. */
        u16 size;

        /** Length of string without trailing nul in bytes. */
        u16 length;

        /** UTF-8 or UTF-16 string. Nul terminated. */
        union {
                u8 utf8[2];
                u16 utf16[1];
                u16 ucs2[1]; /* misnomer, use utf16. */
        } string;
};
VMMDEV_ASSERT_SIZE(shfl_string, 6);

/* The size of shfl_string w/o the string part. */
#define SHFLSTRING_HEADER_SIZE  4

/* Calculate size of the string. */
static inline u32 shfl_string_buf_size(const struct shfl_string *string)
{
        return string ? SHFLSTRING_HEADER_SIZE + string->size : 0;
}

/* Set user id on execution (S_ISUID). */
#define SHFL_UNIX_ISUID             0004000U
/* Set group id on execution (S_ISGID). */
#define SHFL_UNIX_ISGID             0002000U
/* Sticky bit (S_ISVTX / S_ISTXT). */
#define SHFL_UNIX_ISTXT             0001000U

/* Owner readable (S_IRUSR). */
#define SHFL_UNIX_IRUSR             0000400U
/* Owner writable (S_IWUSR). */
#define SHFL_UNIX_IWUSR             0000200U
/* Owner executable (S_IXUSR). */
#define SHFL_UNIX_IXUSR             0000100U

/* Group readable (S_IRGRP). */
#define SHFL_UNIX_IRGRP             0000040U
/* Group writable (S_IWGRP). */
#define SHFL_UNIX_IWGRP             0000020U
/* Group executable (S_IXGRP). */
#define SHFL_UNIX_IXGRP             0000010U

/* Other readable (S_IROTH). */
#define SHFL_UNIX_IROTH             0000004U
/* Other writable (S_IWOTH). */
#define SHFL_UNIX_IWOTH             0000002U
/* Other executable (S_IXOTH). */
#define SHFL_UNIX_IXOTH             0000001U

/* Named pipe (fifo) (S_IFIFO). */
#define SHFL_TYPE_FIFO              0010000U
/* Character device (S_IFCHR). */
#define SHFL_TYPE_DEV_CHAR          0020000U
/* Directory (S_IFDIR). */
#define SHFL_TYPE_DIRECTORY         0040000U
/* Block device (S_IFBLK). */
#define SHFL_TYPE_DEV_BLOCK         0060000U
/* Regular file (S_IFREG). */
#define SHFL_TYPE_FILE              0100000U
/* Symbolic link (S_IFLNK). */
#define SHFL_TYPE_SYMLINK           0120000U
/* Socket (S_IFSOCK). */
#define SHFL_TYPE_SOCKET            0140000U
/* Whiteout (S_IFWHT). */
#define SHFL_TYPE_WHITEOUT          0160000U
/* Type mask (S_IFMT). */
#define SHFL_TYPE_MASK              0170000U

/* Checks the mode flags indicate a directory (S_ISDIR). */
#define SHFL_IS_DIRECTORY(m)   (((m) & SHFL_TYPE_MASK) == SHFL_TYPE_DIRECTORY)
/* Checks the mode flags indicate a symbolic link (S_ISLNK). */
#define SHFL_IS_SYMLINK(m)     (((m) & SHFL_TYPE_MASK) == SHFL_TYPE_SYMLINK)

/** The available additional information in a shfl_fsobjattr object. */
enum shfl_fsobjattr_add {
        /** No additional information is available / requested. */
        SHFLFSOBJATTRADD_NOTHING = 1,
        /**
         * The additional unix attributes (shfl_fsobjattr::u::unix_attr) are
         *  available / requested.
         */
        SHFLFSOBJATTRADD_UNIX,
        /**
         * The additional extended attribute size (shfl_fsobjattr::u::size) is
         *  available / requested.
         */
        SHFLFSOBJATTRADD_EASIZE,
        /**
         * The last valid item (inclusive).
         * The valid range is SHFLFSOBJATTRADD_NOTHING thru
         * SHFLFSOBJATTRADD_LAST.
         */
        SHFLFSOBJATTRADD_LAST = SHFLFSOBJATTRADD_EASIZE,

        /** The usual 32-bit hack. */
        SHFLFSOBJATTRADD_32BIT_SIZE_HACK = 0x7fffffff
};

/**
 * Additional unix Attributes, these are available when
 * shfl_fsobjattr.additional == SHFLFSOBJATTRADD_UNIX.
 */
struct shfl_fsobjattr_unix {
        /**
         * The user owning the filesystem object (st_uid).
         * This field is ~0U if not supported.
         */
        u32 uid;

        /**
         * The group the filesystem object is assigned (st_gid).
         * This field is ~0U if not supported.
         */
        u32 gid;

        /**
         * Number of hard links to this filesystem object (st_nlink).
         * This field is 1 if the filesystem doesn't support hardlinking or
         * the information isn't available.
         */
        u32 hardlinks;

        /**
         * The device number of the device which this filesystem object resides
         * on (st_dev). This field is 0 if this information is not available.
         */
        u32 inode_id_device;

        /**
         * The unique identifier (within the filesystem) of this filesystem
         * object (st_ino). Together with inode_id_device, this field can be
         * used as a OS wide unique id, when both their values are not 0.
         * This field is 0 if the information is not available.
         */
        u64 inode_id;

        /**
         * User flags (st_flags).
         * This field is 0 if this information is not available.
         */
        u32 flags;

        /**
         * The current generation number (st_gen).
         * This field is 0 if this information is not available.
         */
        u32 generation_id;

        /**
         * The device number of a char. or block device type object (st_rdev).
         * This field is 0 if the file isn't a char. or block device or when
         * the OS doesn't use the major+minor device idenfication scheme.
         */
        u32 device;
} __packed;

/** Extended attribute size. */
struct shfl_fsobjattr_easize {
        /** Size of EAs. */
        s64 cb;
} __packed;

/** Shared folder filesystem object attributes. */
struct shfl_fsobjattr {
        /** Mode flags (st_mode). SHFL_UNIX_*, SHFL_TYPE_*, and SHFL_DOS_*. */
        u32 mode;

        /** The additional attributes available. */
        enum shfl_fsobjattr_add additional;

        /**
         * Additional attributes.
         *
         * Unless explicitly specified to an API, the API can provide additional
         * data as it is provided by the underlying OS.
         */
        union {
                struct shfl_fsobjattr_unix unix_attr;
                struct shfl_fsobjattr_easize size;
        } __packed u;
} __packed;
VMMDEV_ASSERT_SIZE(shfl_fsobjattr, 44);

struct shfl_timespec {
        s64 ns_relative_to_unix_epoch;
};

/** Filesystem object information structure. */
struct shfl_fsobjinfo {
        /**
         * Logical size (st_size).
         * For normal files this is the size of the file.
         * For symbolic links, this is the length of the path name contained
         * in the symbolic link.
         * For other objects this fields needs to be specified.
         */
        s64 size;

        /** Disk allocation size (st_blocks * DEV_BSIZE). */
        s64 allocated;

        /** Time of last access (st_atime). */
        struct shfl_timespec access_time;

        /** Time of last data modification (st_mtime). */
        struct shfl_timespec modification_time;

        /**
         * Time of last status change (st_ctime).
         * If not available this is set to modification_time.
         */
        struct shfl_timespec change_time;

        /**
         * Time of file birth (st_birthtime).
         * If not available this is set to change_time.
         */
        struct shfl_timespec birth_time;

        /** Attributes. */
        struct shfl_fsobjattr attr;

} __packed;
VMMDEV_ASSERT_SIZE(shfl_fsobjinfo, 92);

/**
 * result of an open/create request.
 * Along with handle value the result code
 * identifies what has happened while
 * trying to open the object.
 */
enum shfl_create_result {
        SHFL_NO_RESULT,
        /** Specified path does not exist. */
        SHFL_PATH_NOT_FOUND,
        /** Path to file exists, but the last component does not. */
        SHFL_FILE_NOT_FOUND,
        /** File already exists and either has been opened or not. */
        SHFL_FILE_EXISTS,
        /** New file was created. */
        SHFL_FILE_CREATED,
        /** Existing file was replaced or overwritten. */
        SHFL_FILE_REPLACED
};

/* No flags. Initialization value. */
#define SHFL_CF_NONE                  (0x00000000)

/*
 * Only lookup the object, do not return a handle. When this is set all other
 * flags are ignored.
 */
#define SHFL_CF_LOOKUP                (0x00000001)

/*
 * Open parent directory of specified object.
 * Useful for the corresponding Windows FSD flag
 * and for opening paths like \\dir\\*.* to search the 'dir'.
 */
#define SHFL_CF_OPEN_TARGET_DIRECTORY (0x00000002)

/* Create/open a directory. */
#define SHFL_CF_DIRECTORY             (0x00000004)

/*
 *  Open/create action to do if object exists
 *  and if the object does not exists.
 *  REPLACE file means atomically DELETE and CREATE.
 *  OVERWRITE file means truncating the file to 0 and
 *  setting new size.
 *  When opening an existing directory REPLACE and OVERWRITE
 *  actions are considered invalid, and cause returning
 *  FILE_EXISTS with NIL handle.
 */
#define SHFL_CF_ACT_MASK_IF_EXISTS      (0x000000f0)
#define SHFL_CF_ACT_MASK_IF_NEW         (0x00000f00)

/* What to do if object exists. */
#define SHFL_CF_ACT_OPEN_IF_EXISTS      (0x00000000)
#define SHFL_CF_ACT_FAIL_IF_EXISTS      (0x00000010)
#define SHFL_CF_ACT_REPLACE_IF_EXISTS   (0x00000020)
#define SHFL_CF_ACT_OVERWRITE_IF_EXISTS (0x00000030)

/* What to do if object does not exist. */
#define SHFL_CF_ACT_CREATE_IF_NEW       (0x00000000)
#define SHFL_CF_ACT_FAIL_IF_NEW         (0x00000100)

/* Read/write requested access for the object. */
#define SHFL_CF_ACCESS_MASK_RW          (0x00003000)

/* No access requested. */
#define SHFL_CF_ACCESS_NONE             (0x00000000)
/* Read access requested. */
#define SHFL_CF_ACCESS_READ             (0x00001000)
/* Write access requested. */
#define SHFL_CF_ACCESS_WRITE            (0x00002000)
/* Read/Write access requested. */
#define SHFL_CF_ACCESS_READWRITE        (0x00003000)

/* Requested share access for the object. */
#define SHFL_CF_ACCESS_MASK_DENY        (0x0000c000)

/* Allow any access. */
#define SHFL_CF_ACCESS_DENYNONE         (0x00000000)
/* Do not allow read. */
#define SHFL_CF_ACCESS_DENYREAD         (0x00004000)
/* Do not allow write. */
#define SHFL_CF_ACCESS_DENYWRITE        (0x00008000)
/* Do not allow access. */
#define SHFL_CF_ACCESS_DENYALL          (0x0000c000)

/* Requested access to attributes of the object. */
#define SHFL_CF_ACCESS_MASK_ATTR        (0x00030000)

/* No access requested. */
#define SHFL_CF_ACCESS_ATTR_NONE        (0x00000000)
/* Read access requested. */
#define SHFL_CF_ACCESS_ATTR_READ        (0x00010000)
/* Write access requested. */
#define SHFL_CF_ACCESS_ATTR_WRITE       (0x00020000)
/* Read/Write access requested. */
#define SHFL_CF_ACCESS_ATTR_READWRITE   (0x00030000)

/*
 * The file is opened in append mode.
 * Ignored if SHFL_CF_ACCESS_WRITE is not set.
 */
#define SHFL_CF_ACCESS_APPEND           (0x00040000)

/** Create parameters buffer struct for SHFL_FN_CREATE call */
struct shfl_createparms {
        /** Returned handle of opened object. */
        u64 handle;

        /** Returned result of the operation */
        enum shfl_create_result result;

        /** SHFL_CF_* */
        u32 create_flags;

        /**
         * Attributes of object to create and
         * returned actual attributes of opened/created object.
         */
        struct shfl_fsobjinfo info;
} __packed;

/** Shared Folder directory information */
struct shfl_dirinfo {
        /** Full information about the object. */
        struct shfl_fsobjinfo info;
        /**
         * The length of the short field (number of UTF16 chars).
         * It is 16-bit for reasons of alignment.
         */
        u16 short_name_len;
        /**
         * The short name for 8.3 compatibility.
         * Empty string if not available.
         */
        u16 short_name[14];
        struct shfl_string name;
};

/** Shared folder filesystem properties. */
struct shfl_fsproperties {
        /**
         * The maximum size of a filesystem object name.
         * This does not include the '\\0'.
         */
        u32 max_component_len;

        /**
         * True if the filesystem is remote.
         * False if the filesystem is local.
         */
        bool remote;

        /**
         * True if the filesystem is case sensitive.
         * False if the filesystem is case insensitive.
         */
        bool case_sensitive;

        /**
         * True if the filesystem is mounted read only.
         * False if the filesystem is mounted read write.
         */
        bool read_only;

        /**
         * True if the filesystem can encode unicode object names.
         * False if it can't.
         */
        bool supports_unicode;

        /**
         * True if the filesystem is compresses.
         * False if it isn't or we don't know.
         */
        bool compressed;

        /**
         * True if the filesystem compresses of individual files.
         * False if it doesn't or we don't know.
         */
        bool file_compression;
};
VMMDEV_ASSERT_SIZE(shfl_fsproperties, 12);

struct shfl_volinfo {
        s64 total_allocation_bytes;
        s64 available_allocation_bytes;
        u32 bytes_per_allocation_unit;
        u32 bytes_per_sector;
        u32 serial;
        struct shfl_fsproperties properties;
};


/** SHFL_FN_MAP_FOLDER Parameters structure. */
struct shfl_map_folder {
        /**
         * pointer, in:
         * Points to struct shfl_string buffer.
         */
        struct vmmdev_hgcm_function_parameter path;

        /**
         * pointer, out: SHFLROOT (u32)
         * Root handle of the mapping which name is queried.
         */
        struct vmmdev_hgcm_function_parameter root;

        /**
         * pointer, in: UTF16
         * Path delimiter
         */
        struct vmmdev_hgcm_function_parameter delimiter;

        /**
         * pointer, in: SHFLROOT (u32)
         * Case senstive flag
         */
        struct vmmdev_hgcm_function_parameter case_sensitive;

};

/* Number of parameters */
#define SHFL_CPARMS_MAP_FOLDER (4)


/** SHFL_FN_UNMAP_FOLDER Parameters structure. */
struct shfl_unmap_folder {
        /**
         * pointer, in: SHFLROOT (u32)
         * Root handle of the mapping which name is queried.
         */
        struct vmmdev_hgcm_function_parameter root;

};

/* Number of parameters */
#define SHFL_CPARMS_UNMAP_FOLDER (1)


/** SHFL_FN_CREATE Parameters structure. */
struct shfl_create {
        /**
         * pointer, in: SHFLROOT (u32)
         * Root handle of the mapping which name is queried.
         */
        struct vmmdev_hgcm_function_parameter root;

        /**
         * pointer, in:
         * Points to struct shfl_string buffer.
         */
        struct vmmdev_hgcm_function_parameter path;

        /**
         * pointer, in/out:
         * Points to struct shfl_createparms buffer.
         */
        struct vmmdev_hgcm_function_parameter parms;

};

/* Number of parameters */
#define SHFL_CPARMS_CREATE (3)


/** SHFL_FN_CLOSE Parameters structure. */
struct shfl_close {
        /**
         * pointer, in: SHFLROOT (u32)
         * Root handle of the mapping which name is queried.
         */
        struct vmmdev_hgcm_function_parameter root;

        /**
         * value64, in:
         * SHFLHANDLE (u64) of object to close.
         */
        struct vmmdev_hgcm_function_parameter handle;

};

/* Number of parameters */
#define SHFL_CPARMS_CLOSE (2)


/** SHFL_FN_READ Parameters structure. */
struct shfl_read {
        /**
         * pointer, in: SHFLROOT (u32)
         * Root handle of the mapping which name is queried.
         */
        struct vmmdev_hgcm_function_parameter root;

        /**
         * value64, in:
         * SHFLHANDLE (u64) of object to read from.
         */
        struct vmmdev_hgcm_function_parameter handle;

        /**
         * value64, in:
         * Offset to read from.
         */
        struct vmmdev_hgcm_function_parameter offset;

        /**
         * value64, in/out:
         * Bytes to read/How many were read.
         */
        struct vmmdev_hgcm_function_parameter cb;

        /**
         * pointer, out:
         * Buffer to place data to.
         */
        struct vmmdev_hgcm_function_parameter buffer;

};

/* Number of parameters */
#define SHFL_CPARMS_READ (5)


/** SHFL_FN_WRITE Parameters structure. */
struct shfl_write {
        /**
         * pointer, in: SHFLROOT (u32)
         * Root handle of the mapping which name is queried.
         */
        struct vmmdev_hgcm_function_parameter root;

        /**
         * value64, in:
         * SHFLHANDLE (u64) of object to write to.
         */
        struct vmmdev_hgcm_function_parameter handle;

        /**
         * value64, in:
         * Offset to write to.
         */
        struct vmmdev_hgcm_function_parameter offset;

        /**
         * value64, in/out:
         * Bytes to write/How many were written.
         */
        struct vmmdev_hgcm_function_parameter cb;

        /**
         * pointer, in:
         * Data to write.
         */
        struct vmmdev_hgcm_function_parameter buffer;

};

/* Number of parameters */
#define SHFL_CPARMS_WRITE (5)


/*
 * SHFL_FN_LIST
 * Listing information includes variable length RTDIRENTRY[EX] structures.
 */

#define SHFL_LIST_NONE                  0
#define SHFL_LIST_RETURN_ONE            1

/** SHFL_FN_LIST Parameters structure. */
struct shfl_list {
        /**
         * pointer, in: SHFLROOT (u32)
         * Root handle of the mapping which name is queried.
         */
        struct vmmdev_hgcm_function_parameter root;

        /**
         * value64, in:
         * SHFLHANDLE (u64) of object to be listed.
         */
        struct vmmdev_hgcm_function_parameter handle;

        /**
         * value32, in:
         * List flags SHFL_LIST_*.
         */
        struct vmmdev_hgcm_function_parameter flags;

        /**
         * value32, in/out:
         * Bytes to be used for listing information/How many bytes were used.
         */
        struct vmmdev_hgcm_function_parameter cb;

        /**
         * pointer, in/optional
         * Points to struct shfl_string buffer that specifies a search path.
         */
        struct vmmdev_hgcm_function_parameter path;

        /**
         * pointer, out:
         * Buffer to place listing information to. (struct shfl_dirinfo)
         */
        struct vmmdev_hgcm_function_parameter buffer;

        /**
         * value32, in/out:
         * Indicates a key where the listing must be resumed.
         * in: 0 means start from begin of object.
         * out: 0 means listing completed.
         */
        struct vmmdev_hgcm_function_parameter resume_point;

        /**
         * pointer, out:
         * Number of files returned
         */
        struct vmmdev_hgcm_function_parameter file_count;
};

/* Number of parameters */
#define SHFL_CPARMS_LIST (8)


/** SHFL_FN_READLINK Parameters structure. */
struct shfl_readLink {
        /**
         * pointer, in: SHFLROOT (u32)
         * Root handle of the mapping which name is queried.
         */
        struct vmmdev_hgcm_function_parameter root;

        /**
         * pointer, in:
         * Points to struct shfl_string buffer.
         */
        struct vmmdev_hgcm_function_parameter path;

        /**
         * pointer, out:
         * Buffer to place data to.
         */
        struct vmmdev_hgcm_function_parameter buffer;

};

/* Number of parameters */
#define SHFL_CPARMS_READLINK (3)


/* SHFL_FN_INFORMATION */

/* Mask of Set/Get bit. */
#define SHFL_INFO_MODE_MASK    (0x1)
/* Get information */
#define SHFL_INFO_GET          (0x0)
/* Set information */
#define SHFL_INFO_SET          (0x1)

/* Get name of the object. */
#define SHFL_INFO_NAME         (0x2)
/* Set size of object (extend/trucate); only applies to file objects */
#define SHFL_INFO_SIZE         (0x4)
/* Get/Set file object info. */
#define SHFL_INFO_FILE         (0x8)
/* Get volume information. */
#define SHFL_INFO_VOLUME       (0x10)

/** SHFL_FN_INFORMATION Parameters structure. */
struct shfl_information {
        /**
         * pointer, in: SHFLROOT (u32)
         * Root handle of the mapping which name is queried.
         */
        struct vmmdev_hgcm_function_parameter root;

        /**
         * value64, in:
         * SHFLHANDLE (u64) of object to be listed.
         */
        struct vmmdev_hgcm_function_parameter handle;

        /**
         * value32, in:
         * SHFL_INFO_*
         */
        struct vmmdev_hgcm_function_parameter flags;

        /**
         * value32, in/out:
         * Bytes to be used for information/How many bytes were used.
         */
        struct vmmdev_hgcm_function_parameter cb;

        /**
         * pointer, in/out:
         * Information to be set/get (shfl_fsobjinfo or shfl_string). Do not
         * forget to set the shfl_fsobjinfo::attr::additional for a get
         * operation as well.
         */
        struct vmmdev_hgcm_function_parameter info;

};

/* Number of parameters */
#define SHFL_CPARMS_INFORMATION (5)


/* SHFL_FN_REMOVE */

#define SHFL_REMOVE_FILE        (0x1)
#define SHFL_REMOVE_DIR         (0x2)
#define SHFL_REMOVE_SYMLINK     (0x4)

/** SHFL_FN_REMOVE Parameters structure. */
struct shfl_remove {
        /**
         * pointer, in: SHFLROOT (u32)
         * Root handle of the mapping which name is queried.
         */
        struct vmmdev_hgcm_function_parameter root;

        /**
         * pointer, in:
         * Points to struct shfl_string buffer.
         */
        struct vmmdev_hgcm_function_parameter path;

        /**
         * value32, in:
         * remove flags (file/directory)
         */
        struct vmmdev_hgcm_function_parameter flags;

};

#define SHFL_CPARMS_REMOVE  (3)


/* SHFL_FN_RENAME */

#define SHFL_RENAME_FILE                (0x1)
#define SHFL_RENAME_DIR                 (0x2)
#define SHFL_RENAME_REPLACE_IF_EXISTS   (0x4)

/** SHFL_FN_RENAME Parameters structure. */
struct shfl_rename {
        /**
         * pointer, in: SHFLROOT (u32)
         * Root handle of the mapping which name is queried.
         */
        struct vmmdev_hgcm_function_parameter root;

        /**
         * pointer, in:
         * Points to struct shfl_string src.
         */
        struct vmmdev_hgcm_function_parameter src;

        /**
         * pointer, in:
         * Points to struct shfl_string dest.
         */
        struct vmmdev_hgcm_function_parameter dest;

        /**
         * value32, in:
         * rename flags (file/directory)
         */
        struct vmmdev_hgcm_function_parameter flags;

};

#define SHFL_CPARMS_RENAME  (4)


/** SHFL_FN_SYMLINK Parameters structure. */
struct shfl_symlink {
        /**
         * pointer, in: SHFLROOT (u32)
         * Root handle of the mapping which name is queried.
         */
        struct vmmdev_hgcm_function_parameter root;

        /**
         * pointer, in:
         * Points to struct shfl_string of path for the new symlink.
         */
        struct vmmdev_hgcm_function_parameter new_path;

        /**
         * pointer, in:
         * Points to struct shfl_string of destination for symlink.
         */
        struct vmmdev_hgcm_function_parameter old_path;

        /**
         * pointer, out:
         * Information about created symlink.
         */
        struct vmmdev_hgcm_function_parameter info;

};

#define SHFL_CPARMS_SYMLINK  (4)

#endif