Filer
ExtendedAttributes.h
1 /*-
2  * Copyright (c) 2022-23 Simon Peter <probono@puredarwin.org>
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  * notice, this list of conditions and the following disclaimer in the
12  * documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS "AS IS" AND
15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24  * SUCH DAMAGE.
25  */
26 
27 /* We are using command line tools to modify extended attributes because
28  * we can set those tools to setuid root. This allows us to set extended
29  * attributes on files that we do not have write access to.
30  */
31 
32 #ifndef EXTENDEDATTRIBUTES_H
33 #define EXTENDEDATTRIBUTES_H
34 
35 #include <QFile>
36 #include <QByteArray>
37 
42 {
43 public:
48  ExtendedAttributes(const QString &filePath);
49 
56  bool write(const QString &attributeName, const QByteArray &attributeValue);
57 
63  QByteArray read(const QString &attributeName);
64 
65  bool clear(const QString &attributeName);
66 
67 private:
68  QFile m_file;
69 };
70 
71 #endif // EXTENDEDATTRIBUTES_H
The ExtendedAttributes class provides functionality to read and write extended attributes of a file.
Definition: ExtendedAttributes.h:42
QByteArray read(const QString &attributeName)
Reads the value of an extended attribute from the file.
Definition: ExtendedAttributes.cpp:101
ExtendedAttributes(const QString &filePath)
Constructs an ExtendedAttributes object for the specified file.
Definition: ExtendedAttributes.cpp:42
bool write(const QString &attributeName, const QByteArray &attributeValue)
Writes an extended attribute for the file.
Definition: ExtendedAttributes.cpp:44