LC.fs.*¶

Das Modul LC.fs stellt Funktionen zur Verwaltung von Dateien und Verzeichnissen bereit.

LC.fs.basename(filename)¶

Parameter

• filename (String) – file name to extract basename from

Rückgabe

base name (file name without path)

LC.fs.copy(sourcefile, destfile)¶

Parameter

• sourcefile (String) – Quell-Dateiname

• destfile (String) – Ziel-Dateiname

Rückgabe

true oder false + Fehlermeldung

Kopiert die Datei sourcefile nach destfile. Die Dateieigenschaften (Besitzer, Berechtigungen und Änderungs-/Zugriffsdatum) bleiben dabei erhalten.

LC.fs.dirname(filename)¶

Parameter

• filename (String) – file name to extract directory name from

Rückgabe

directory name (without file name)

LC.fs.filecount(path)¶

Parameter

• path (String) – directory name to count files in

Rückgabe

Anzahl der Dateien in dem Verzeichnis, oder false + Fehlermeldung

Return the number of files and directories in path (excluding . and ..). Non-recursive.

LC.fs.glob(pattern)¶

Parameter

• pattern (String) – zu suchendes Dateisystem-Muster

Rückgabe

Array mit passenden Dateinamen

Build a list of file names which match pattern (e.g. /etc/liveconfig/lua.d/*.lua). If no matching files are found, an empty list is returned. The results are sorted alphabetically.

LC.fs.is_dir(name)¶

Parameter

• name (String) – zu prüfender Dateiname

Rückgabe

true oder false

Gibt true zurück wenn name ein Verzeichnis ist.

LC.fs.is_file(name)¶

Parameter

• name (String) – zu prüfender Dateiname

Rückgabe

true oder false

Gibt true zurück wenn name eine reguläre Datei ist.

LC.fs.is_symlink(name)¶

Parameter

• name (String) – zu prüfender Dateiname

Rückgabe

true oder false

Gibt true zurück wenn name ein symbolischer Link ist.

LC.fs.mkdir(name)¶

Parameter

• name (String) – zu erstellender Verzeichnisname

Rückgabe

true oder false + Fehlermeldung

Erstellt ein neues Verzeichnis.

LC.fs.mkdir_rec(name[, mode, user, group])¶

Parameter

• name (String) – zu erstellender Verzeichnisname

• mode (String) – permission mode (octal value as string, e.g. 0755)

• user (String) – directory owner (user) (default: root)

• group (String) – directory owner (group) (default: root)

Rückgabe

true oder false + Fehlermeldung

Create a new directory. If one or more of the parent directories don’t exist, they’re also created.

The parameters mode, user and group are optional. If a directory is created recursively, all parent directories are also created with mode, user and group.

LC.fs.parse_ini(filename)¶

Parameter

• filename (String) – name of file to parse

Rückgabe

table with key-value-pairs of .ini content

This function parses the given file (.ini format) and returns the contents as key-value-pairs. If an error occurs, it returns nil and an error string.

LC.fs.rename(oldname, newname)¶

Parameter

• oldname (String) – umzubenennende Datei oder Verzeichnis

• newname (String) – neuer Name

Rückgabe

true oder false + Fehlermeldung

Rename a file or a directory from oldname to newname.

LC.fs.setperm(name, mode, user, group)¶

Parameter

• name (String) – Datei- oder Verzeichnisname

• mode (String) – new file mode (octal value, must be submitted as string!)

• user (String) – Dateibesitzer (Benutzer)

• group (String) – Dateibesitzer (Gruppe)

Rückgabe

true oder false + Fehlermeldung

Change the permissions for the file or directory name. The new permissions must be submitted as string with an octal value (e.g. "0755"), and user/group is the new file owner name.

LC.fs.setUserQuota(user, path, limit)¶

Parameter

• user (String) – user to set quota for

• path (String) – file system (path) to set quota

• limit (Number) – quota limit (kB)

Rückgabe

true oder false + Fehlermeldung

Set the diskspace quota for user user on the device mounted at path to limit kilobyte.

Example: set limit for user v12007 on /var/www/v12007 to 200 MB (=204800 kB):

LC.fs.setUserQuota("v12007", "/var/www/v12007", 204800)

LC.fs.setGroupQuota(group, path, limit)¶

Parameter

• group (String) – group to set quota for

• path (String) – file system (path) to set quota

• limit (Number) – quota limit (kB)

Rückgabe

true oder false + Fehlermeldung

Set the diskspace quota for group group on the device mounted at path to limit kilobyte.

LC.fs.getUserQuota(user, path)¶

Parameter

• user (String) – user to get quota for

• path (String) – Dateisystem (Pfad)

Rückgabe

table or nil + error message (see description)

Get the diskspace quota for user user on the device mounted at path. The results are returned as table with the following fields:

• kb_soft soft limit in kilobytes (1024 bytes)

• kb_hard hard limit

• kb_used disk space actually used

• n_soft soft limit of inodes (number of files & directories)

• n_hard hard limit of inodes

• n_used number of inodes in use

If an error occured, nil and an error message (String) is returned.

LC.fs.getGroupQuota(group, path)¶

Parameter

• group (String) – group to get quota for

• path (String) – Dateisystem (Pfad)

Rückgabe

table or nil + error message (see description)

Get the diskspace quota for group group on the device mounted at path. The result table is analogous to LC.fs.getUserQuota().