> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# show_directories

<div className="kinetica-pydoc">
  <div className="dl py method">
    <div className="dt sig sig-object py" id="gpudb.GPUdb.show_directories"> <span className="sig-name descname"><span className="pre">show\_directories</span></span><span className="sig-paren">(</span><span className="em sig-param"><span className="n"><span className="pre">directory\_name</span></span><span className="o"><span className="pre">=</span></span><span className="default_value"><span className="pre">''</span></span></span>, <span className="em sig-param"><span className="n"><span className="pre">options</span></span><span className="o"><span className="pre">=</span></span><span className="default_value"><span className="pre">{"{"}{"}"}</span></span></span><span className="sig-paren">)</span><a href="https://github.com/kineticadb/kinetica-api-python/blob/master/gpudb/gpudb.py#L38498"><span className="viewcode-link"><span className="pre">\[source]</span></span></a></div>

    <div className="dd">
      <p>Shows information about directories in <a className="reference external" href="/content/tools/kifs/">KiFS</a>. Can be used to show a single directory, or all directories.</p>
      <p><strong>Parameters</strong></p>

      <div className="blockquote">
        <div>
          <div className="dl simple">
            <div className="dt">directory\_name (<span className="em">str</span>) –</div>

            <div className="dd">
              <p>The KiFS directory name to show. If empty, shows all directories. The default value is ‘’.</p>
            </div>

            <div className="dt">options (<span className="em">dict of str to str</span>) –</div>

            <div className="dd">
              <p>Optional parameters. The default value is an empty dict ( {"{"}{"}"} ).</p>
            </div>
          </div>
        </div>
      </div>

      <p><strong>Returns</strong></p>

      <div className="blockquote">
        <div>
          <p>A dict with the following entries–</p>

          <div className="dl simple">
            <div className="dt">directories (<span className="em">list of str</span>) –</div>

            <div className="dd">
              <p>KiFS directory names.</p>
            </div>

            <div className="dt">users (<span className="em">list of str</span>) –</div>

            <div className="dd">
              <p>User that created each directory for the respective directories in output parameter <span className="em">directories</span>.</p>
            </div>

            <div className="dt">creation\_times (<span className="em">list of longs</span>) –</div>

            <div className="dd">
              <p>The creation time for each directory in milliseconds since epoch, for the respective directories in output parameter <span className="em">directories</span>.</p>
            </div>

            <div className="dt">data\_usages (<span className="em">list of longs</span>) –</div>

            <div className="dd">
              <p>The data usage each directory in bytes, for the respective directories in output parameter <span className="em">directories</span>.</p>
            </div>

            <div className="dt">data\_limits (<span className="em">list of longs</span>) –</div>

            <div className="dd">
              <p>The data limit for each directory in bytes, for the respective directories in output parameter <span className="em">directories</span>.</p>
            </div>

            <div className="dt">permissions (<span className="em">list of str</span>) –</div>

            <div className="dd">
              <p>Highest level of permission the calling user has for the respective directories in output parameter <span className="em">directories</span>. Will be empty if no permissions. If a user has been granted both read and write permissions, ‘directory\_write’ will be listed.</p>
            </div>

            <div className="dt">info (<span className="em">dict of str to str</span>) –</div>

            <div className="dd">
              <p>Additional information.</p>
            </div>
          </div>
        </div>
      </div>
    </div>
  </div>
</div>