VFS Logging

FS_Unmount

Hint for the VFS-API that the VFS will be unmounted now.

-

-

FS_Getattr

Request for file system metadata (number of files/folders, used storage space, etc.)

-

capacity( usedBytes / sizeVfs ) nodes( files / dirs / max ) date

usedBytes: Used bytes on the storage

sizeVfs: Capacity of the storage (total size)

files: Total number of files on the storage

dirs: Total number of directories on the storage

max: Maximum number of files/folders

date: Last modification date

Example: capacity(0/123432) nodes(1/4/432523423)

FS_VGet___

Request of file/folder metadata by its unique id. (filename, size, modification date, etc.)

-

N_xxx perm refCnt uid gid size date

N_xxx: unique ID of file/folder

perm: access rights, using Unix notation (d=directory, r=read, w=write, x=execute - 1. rwx = user, 2. rwx = group, 3. rwx = others).

refCnt: Number of files in a directory

uid: User-ID (Owner of a file/folder)

gid: Group-ID (group of the owner)

size: file size

date: Last modification date of file/folder

Example: N_1 drwxr-xr-x 1 uid(0) gid(0) 0 bytes 06 Jul 2016, 08:19 service

VN_Lookup_

Request if a specified file/folder name exists within a given folder. If it exists, the VFS-API replies with the metadata of the file/folder.

name [ idx , len , path ]

name: name of a file/folder, to be searched below of folder with ID N_xxx (Group C).

path: Complete path of the request (if available)

idx: Index position, of the name within the path.

len: length of the searched name within the path

Example: service [19, 7, /Volumes/localhost/service]

N_xxx perm refCnt uid gid size date

N_xxx: unique ID of file/folder

perm: access rights, using Unix notation (d=directory, r=read, w=write, x=execute - 1. rwx = user, 2. rwx = group, 3. rwx = others).

refCnt: Number of files in a directory

uid: User-ID (Owner of a file/folder)

gid: Group-ID (group of the owner)

size: file size

date: Last modification date of file/folder

Example: N_1 drwxr-xr-x 1 uid(0) gid(0) 0 bytes 06 Jul 2016, 08:19 service

VN_Open___

Processing instruction to open a file/folder for read and/or write access.

Mode: hex ( r.w )

hex: Processing mode in HEX to open the file/directory.

r.w.: text representation of the processing mode:

r = read mode disabled or R = read-mode enabled

w = write-mode disabled or W = write-mode enabled.

Example: Mode:0x0001 (R.w)

-

VN_Close__

Processing instruction to close a file/folder.

Mode: hex ( r.w )

hex: Processing mode in HEX to open the file/directory.

r.w.: text representation of the processing mode:

r = read mode disabled or R = read-mode enabled

w = write-mode disabled or W = write-mode enabled.

Example: Mode:0x0001 (R.w)

-

VN_Getattr

Request of file/folder metadata by its unique ID. (Filename, size, modification date, etc.) This is equivalent to FS_VGet___

-

N_xxx perm refCnt uid gid size date

N_xxx: unique ID of file/folder

perm: access rights, using Unix notation (d=directory, r=read, w=write, x=execute - 1. rwx = user, 2. rwx = group, 3. rwx = others).

refCnt: Number of files in a directory

uid: User-ID (Owner of a file/folder)

gid: Group-ID (group of the owner)

size: file size

date: Last modification date of file/folder

Example: N_1 drwxr-xr-x 1 uid(0) gid(0) 0 bytes 06 Jul 2016, 08:19 service

VN_Read___

Read n bytes of a file up to a length of m.

[ offset , len ]

offset: start offset for read requests (n-th. byte or n-th. directory entry).

len: maximum number of expected bytes (or directory entries).

Example: [0, 330792]

size bytes [hex]

size: Number of returned bytes

hex: Extract of the first 8 as well as the last 8 read bytes in HEX.

Example: 330792 bytes [255044462d312e35 ... 320d2525454f460d]

VN_Readdir

Read the content of a directory. The reply is a list of file/folder names and its corresponding unique ID.

[ offset , len ]

offset: start offset for read requests (n-th. byte or n-th. directory entry).

len: maximum number of expected bytes (or directory entries).

Example: [0, 330792]

num entries eof { id dir name }

num: Number of directory entries processed in this result

eof: EOF if the end of the directory is reached or eof if there are some additional entries to be processed.

id: unique ID of the file/folder

dir: d if the entry is a directory or - if it is a file.

name: Name of the file/folder

Example: 1 entry EOF {28 - foo.png}

___INVALID

Invalid requests

-

-

-

0

OFF

Log is disabled

WARNING

1

ERRORS 

Only errors will be reported. This might be negative replies as well as operational errors, e.g.: "does file X exist?" -> "no".

INFO

2

FILES & DIRECTORIES 

Requests corresponding to files and folders (open, close, read, search):

• VN_Open___
• VN_Close__ 
• VN_Read___
• VN_Lookup_
• VN_Readdir

CONFIG

3

FILE SYSTEM 

Requests corresponding to the file system itself (mount, unmount, filesystem attributes):

• FS_Unmount
• FS_Getattr
• FS_VGet___

DEBUG

4

ALL

All VFS requests including some additional debug information.