---
name: "lfc-listgrpmap"
section: "1"
platform: "linux"
package: "lfc"
version: "1.10.0-2+b3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/lfc-listgrpmap"
---

# lfc-listgrpmap(1)

query about a given group or list all existing groups in virtual gid table

## NAME

lfc-listgrpmap - query about a given group or list all existing groups in virtual gid table

## SYNOPSIS

**lfc-listgrpmap** \[ **--gid** *gid* \] \[ **--group** *groupname* \]

## DESCRIPTION

**lfc-listgrpmap** queries about a given group or lists all existing groups in virtual gid table.

This function requires ADMIN privilege.

## OPTIONS

- **--gid** *gid*

  specifies the Virtual Group Id.

- **--group** *groupname*

  specifies the group name.

## EXAMPLES

```
lfc-listgrpmap --gid 2688
    2688 dteam

lfc-listgrpmap --group dteam
    2688 dteam

lfc-listgrpmap
    2688 dteam
    2689 ops
```

## EXIT STATUS

This program returns 0 if the operation was successful or \>0 if the operation failed.

## SEE ALSO

**[Castor\_limits(4)](/Castor_limits/4.md)**, **[lfc\_getgrpbynam(3)](/lfc_getgrpbynam/3.md)**, **[lfc\_getgrpbygid(3)](/lfc_getgrpbygid/3.md)**