File indexing completed on 2024-04-28 11:40:50

 // -*- c++ -*-
 /*
     This file is part of the KDE libraries
     SPDX-FileCopyrightText: 2000 David Faure <faure@kde.org>
 
     SPDX-License-Identifier: LGPL-2.0-or-later
 */
 
 #ifndef KIO_CHMODJOB_H
 #define KIO_CHMODJOB_H
 
 #include "global.h"
 #include "job_base.h"
 #include "kiocore_export.h"
 #include <kfileitem.h>
 
 namespace KIO
 {
 class ChmodJobPrivate;
 /**
  * @class KIO::ChmodJob chmodjob.h <KIO/ChmodJob>
  *
  * This job changes permissions on a list of files or directories,
  * optionally in a recursive manner.
  * @see KIO::chmod()
  */
 class KIOCORE_EXPORT ChmodJob : public KIO::Job
 {
     Q_OBJECT
 public:
     ~ChmodJob() override;
 
 protected Q_SLOTS:
     void slotResult(KJob *job) override;
 
 protected:
     KIOCORE_NO_EXPORT explicit ChmodJob(ChmodJobPrivate &dd);
 
 private:
     Q_DECLARE_PRIVATE(ChmodJob)
 };
 
 /**
  * Creates a job that changes permissions/ownership on several files or directories,
  * optionally recursively.
  * This version of chmod uses a KFileItemList so that it directly knows
  * what to do with the items. TODO: a version that takes a QList<QUrl>,
  * and a general job that stats each url and returns a KFileItemList.
  *
  * Note that change of ownership is only supported for local files.
  *
  * Inside directories, the "x" bits will only be changed for files that had
  * at least one "x" bit before, and for directories.
  * This emulates the behavior of chmod +X.
  *
  * @param lstItems The file items representing several files or directories.
  * @param permissions the permissions we want to set
  * @param mask the bits we are allowed to change.
  * For instance, if mask is 0077, we don't change
  * the "user" bits, only "group" and "others".
  * @param newOwner If non-empty, the new owner for the files
  * @param newGroup If non-empty, the new group for the files
  * @param recursive whether to open directories recursively
  * @param flags We support HideProgressInfo here
  * @return The job handling the operation.
  */
 KIOCORE_EXPORT ChmodJob *chmod(const KFileItemList &lstItems,
                                int permissions,
                                int mask,
                                const QString &newOwner,
                                const QString &newGroup,
                                bool recursive,
                                JobFlags flags = DefaultFlags);
 
 }
 
 #endif