/usr/include/KF5/KIOCore/ksambashare.h is in kio-dev 5.18.0-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 | /* This file is part of the KDE project
Copyright (c) 2004 Jan Schaefer <j_schaef@informatik.uni-kl.de>
Copyright 2010 Rodrigo Belem <rclbelem@gmail.com>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License version 2 as published by the Free Software Foundation.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
#ifndef ksambashare_h
#define ksambashare_h
#include <QtCore/QObject>
#include "kiocore_export.h"
class KSambaShareData;
class KSambaSharePrivate;
/**
* This class lists Samba user shares and monitors them for addition, update and removal.
* Singleton class, call instance() to get an instance.
*/
class KIOCORE_EXPORT KSambaShare : public QObject
{
Q_OBJECT
public:
/**
* @return the one and only instance of KSambaShare.
*/
static KSambaShare *instance();
/**
* Whether or not the given path is shared by Samba.
*
* @param path the path to check if it is shared by Samba.
*
* @return whether the given path is shared by Samba.
*/
bool isDirectoryShared(const QString &path) const;
/**
* Returns a list of all directories shared by local users in Samba.
* The resulting list is not sorted.
*
* @return a list of all directories shared by Samba.
*/
QStringList sharedDirectories() const;
/**
* Tests that a share name is valid and does not conflict with system users names or shares.
*
* @param name the share name.
*
* @return whether the given name is already being used or not.
*
* @since 4.7
*/
bool isShareNameAvailable(const QString &name) const;
/**
* Returns the list of available shares.
*
* @return @c a QStringList containing the user shares names.
* @return @c an empty list if there aren't user shared directories.
*
* @since 4.7
*/
QStringList shareNames() const;
/**
* Returns the KSambaShareData object of the share name.
*
* @param name the share name.
*
* @return @c the KSambaShareData object that matches the name.
* @return @c an empty KSambaShareData object if there isn't match for the name.
*
* @since 4.7
*/
KSambaShareData getShareByName(const QString &name) const;
/**
* Returns a list of KSambaShareData matching the path.
*
* @param path the path that wants to get KSambaShareData object.
*
* @return @c the QList of KSambaShareData objects that matches the path.
* @return @c an empty QList if there aren't matches for the given path.
*
* @since 4.7
*/
QList<KSambaShareData> getSharesByPath(const QString &path) const;
virtual ~KSambaShare();
/**
* Returns the path to the used smb.conf file
* or empty string if no file was found
*
* @return @c the path to the smb.conf file
*
* @deprecated
*/
#ifndef KIOCORE_NO_DEPRECATED
KIOCORE_DEPRECATED QString smbConfPath() const;
#endif
Q_SIGNALS:
/**
* Emitted when a share is updated, added or removed
*/
void changed();
private:
KSambaShare();
KSambaSharePrivate *const d_ptr;
Q_DECLARE_PRIVATE(KSambaShare)
friend class KSambaShareData;
friend class KSambaShareSingleton;
Q_PRIVATE_SLOT(d_func(), void _k_slotFileChange(const QString &))
};
#endif
|