/usr/include/casacore/casa/OS/DOos.h is in casacore-dev 2.2.0-2.
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 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 | //# DOos.h: Functions used to implement the DO functionality
//# Copyright (C) 1999,2000,2001
//# Associated Universities, Inc. Washington DC, USA.
//#
//# This library is free software; you can redistribute it and/or modify it
//# under the terms of the GNU Library General Public License as published by
//# the Free Software Foundation; either version 2 of the License, or (at your
//# option) any later version.
//#
//# 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; if not, write to the Free Software Foundation,
//# Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA.
//#
//# Correspondence concerning AIPS++ should be addressed as follows:
//# Internet email: aips2-request@nrao.edu.
//# Postal address: AIPS++ Project Office
//# National Radio Astronomy Observatory
//# 520 Edgemont Road
//# Charlottesville, VA 22903-2475 USA
//#
//#
//# $Id$
#ifndef CASA_DOOS_H
#define CASA_DOOS_H
//# Includes
#include <casacore/casa/aips.h>
#include <casacore/casa/Arrays/Vector.h>
namespace casacore { //# NAMESPACE CASACORE - BEGIN
//# Forward Declarations
class String;
// <summary>
// DO for accessing os-specific functions
// </summary>
// <use visibility=export>
// <reviewed reviewer="UNKNOWN" date="before2004/08/25" tests="" demos="">
// </reviewed>
// <prerequisite>
// <li> <linkto module=OS>OS</linkto>
// </prerequisite>
// <etymology>
// </etymology>
// <synopsis>
// This class serves as the connection between the OS module and a tasking
// interface in Glish or Python.
// It is meant for access to OS-specific functions, in
// particular file handling.
// </synopsis>
// <example>
// </example>
// <motivation>
// </motivation>
// <thrown>
// <li> AipsError if AIPSPATH or HOME is not defined
// </thrown>
// <todo asof="1997/09/16">
// <li> Check for feasable extensions
// </todo>
class DOos
{
public:
// Are the given path names valid?
// I.e. does a file with the given name exist or can it be created?
static Vector<Bool> isValidPathName (const Vector<String>& pathName);
// Do the given files exist?
// If follow is False, symbolic links are not followed.
static Vector<Bool> fileExists (const Vector<String>& fileName,
Bool follow = True);
// Give the type of the given files.
static Vector<String> fileType (const Vector<String>& fileName,
Bool follow = True);
// Give all file names in the directory matching the given pattern
// and file types.
// <br>The pattern can be a string like the filename pattern given in
// a shell (e.g. '*.cc'). If the string is empty, all files are taken
// into account.
// <br>Filetypes is a string determining which file types will be selected.
// Each character in the string determines a file type. They are:
// <dl>
// <dt>r<dd>regular file
// <dt>d<dd>directory
// <dt>s<dd>symbolic link
// <dt>R<dd>readable file
// <dt>W<dd>writable file
// <dt>X<dd>executable file
// </dl>
// The all flag determines if file names starting with a . will also
// be selected.
static Vector<String> fileNames (const String& directoryName,
const String& fileNamePattern,
const String& fileTypes,
Bool all = False,
Bool follow = True);
// Make directories. It throws an exception if a file with that
// name already exists.
static void makeDirectory (const Vector<String>& directoryNames,
Bool makeParent = False);
// Return the full absolute names for the given names.
static Vector<String> fullName (const Vector<String>& fileName);
// Return the full directory names of the given files.
static Vector<String> dirName (const Vector<String>& fileName);
// Return the base names of the given files.
static Vector<String> baseName (const Vector<String>& fileName);
// Get the time of the given files.
// <src>whichTime</src> determines which time to return:
// <br>1 = time of last access
// <br>2 = time of last modification
// <br>3 = time of last status change
static Vector<Double> fileTime (const Vector<String>& fileName,
Int whichTime = 1, Bool follow = True);
// Return the total size (in bytes) for each file or directory given.
// For a directory the size of all files (recursively) in it is given.
// If follow is False, symbolic links are not followed.
// <group>
static Vector<Double> totalSize (const Vector<String>& fileName,
Bool follow = True);
static Double totalSize (const String& fileName, Bool follow = True);
// </group>
// Return the total size on the devices the given directories are on.
// If follow is False, symbolic links are not followed.
static Vector<Double> freeSpace (const Vector<String>& fileName,
Bool follow = True);
// Copy the file (or directory recursively).
// If from is a symbolic link and follow is False, only the
// symbolic link is copied.
static void copy (const String& to, const String& from,
Bool overwrite = True, Bool follow = True);
// Move the file or directory.
// If from is a symbolic link and follow is False, only the
// symbolic link is moved.
static void move (const String& to, const String& from,
Bool overwrite = True, Bool follow = True);
// Remove the files (or directories recursively).
// If fileName is a symbolic link and follow is False, only the
// symbolic link is removed.
// <group>
static void remove (const String& fileName, Bool recursive,
Bool mustExist = True, Bool follow = True);
static void remove (const Vector<String>& fileNames, Bool recursive,
Bool mustExist = True, Bool follow = True);
// </group>
// Tell if a table is used or locked by another process.
// It returns a vector containing 3 integers.
// The first one tells if the table is in use or locked.
// See <linkto class=LockFile>LockFile</linkto>\::showLock for details.
// The second one gives the pid of the process using/locking the table.
// The third one tells if the table is permanently locked (0 = not).
static Vector<Int> lockInfo (const String& tableName);
};
} //# NAMESPACE CASACORE - END
#endif
|