mirror of
https://github.com/outbackdingo/sysadm.git
synced 2026-01-27 10:20:26 +00:00
7ec47963ac
- Whitespace fixes. - Reworking text. - Reducing the size of tables for better PEP8 conformity. - Altering admonition box titles (use tip and danger). - Update roles (use :guilabel: and verify other uses).
96 lines
2.3 KiB
ReStructuredText
96 lines
2.3 KiB
ReStructuredText
.. _fs:
|
|
|
|
fs
|
|
**
|
|
|
|
The fs class is used to manage the files and directories on the system.
|
|
|
|
Every fs class request contains several parameters:
|
|
|
|
+---------------+-----------+--------------------------------------+
|
|
| **Parameter** | **Value** | **Description** |
|
|
| | | |
|
|
+===============+===========+======================================+
|
|
| id | | Any unique value for the request, |
|
|
| | | including a hash, checksum, or uuid. |
|
|
+---------------+-----------+--------------------------------------+
|
|
| name | fs | |
|
|
| | | |
|
|
+---------------+-----------+--------------------------------------+
|
|
| namespace | sysadm | |
|
|
| | | |
|
|
+---------------+-----------+--------------------------------------+
|
|
| action | | Actions include "dirlist". |
|
|
| | | |
|
|
+---------------+-----------+--------------------------------------+
|
|
|
|
The rest of this section provides examples of the available *actions*
|
|
for each type of request, along with their responses.
|
|
|
|
.. index:: dirlist, fs
|
|
|
|
.. _List Directory:
|
|
|
|
List Directory
|
|
==============
|
|
|
|
The "dirlist" action lists the contents of the specified directory.
|
|
|
|
**REST Request**
|
|
|
|
::
|
|
|
|
PUT /sysadm/fs
|
|
{
|
|
"dir" : "/root",
|
|
"action" : "dirlist"
|
|
}
|
|
|
|
**WebSocket Request**
|
|
|
|
.. code-block:: json
|
|
|
|
{
|
|
"args" : {
|
|
"dir" : "/root",
|
|
"action" : "dirlist"
|
|
},
|
|
"id" : "fooid",
|
|
"name" : "fs",
|
|
"namespace" : "sysadm"
|
|
}
|
|
|
|
**Response**
|
|
|
|
.. code-block:: json
|
|
|
|
{
|
|
"args": {
|
|
"dirlist": {
|
|
"VirtualBox VMs": {
|
|
"dir": true
|
|
},
|
|
"freenas-auto.iso": {
|
|
"group": "wheel",
|
|
"owner": "root",
|
|
"size": 408049664
|
|
},
|
|
"ixbuild": {
|
|
"dir": true
|
|
},
|
|
"pc-sysinstall.cfg": {
|
|
"group": "wheel",
|
|
"owner": "root",
|
|
"size": 1741
|
|
},
|
|
"pc-sysinstall.log": {
|
|
"group": "wheel",
|
|
"owner": "root",
|
|
"size": 125408
|
|
}
|
|
}
|
|
},
|
|
"id": "fooid",
|
|
"name": "response",
|
|
"namespace": "sysadm"
|
|
} |