:orphan:
# DMGetLabel
Return the label of a given name, or `NULL`, from a `DM`
## Synopsis
```
#include "petscdm.h"
#include "petscdmlabel.h"
#include "petscds.h"
PetscErrorCode DMGetLabel(DM dm, const char name[], DMLabel *label)
```
Not Collective
## Input Parameters
- ***dm -*** The `DM` object
- ***name -*** The label name
## Output Parameter
- ***label -*** The `DMLabel`, or `NULL` if the label is absent
## Default labels in a `DMPLEX`
- ***"depth" -*** Holds the depth (co-dimension) of each mesh point
- ***"celltype" -*** Holds the topological type of each cell
- ***"ghost" -*** If the DM is distributed with overlap, this marks the cells and faces in the overlap
- ***"Cell Sets" -*** Mirrors the cell sets defined by GMsh and ExodusII
- ***"Face Sets" -*** Mirrors the face sets defined by GMsh and ExodusII
- ***"Vertex Sets" -*** Mirrors the vertex sets defined by GMsh
## See Also
[](ch_dmbase), `DM`, `DMLabel`, `DMHasLabel()`, `DMGetLabelByNum()`, `DMAddLabel()`, `DMCreateLabel()`, `DMHasLabel()`, `DMPlexGetDepthLabel()`, `DMPlexGetCellType()`
## Level
intermediate
## Location
src/dm/interface/dm.c
## Examples
src/dm/impls/plex/tutorials/ex10.c
src/dm/impls/plex/tutorials/ex1f90.F90
src/dm/impls/plex/tutorials/ex6.c
src/dm/label/tutorials/ex1.c
src/dm/label/tutorials/ex1f90.F90
src/snes/tutorials/ex12.c
src/snes/tutorials/ex13.c
src/snes/tutorials/ex17.c
src/snes/tutorials/ex20.c
src/snes/tutorials/ex23.c
src/snes/tutorials/ex24.c
---
[Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/dm/interface/dm.c)
[Index of all DM routines](index.md)
[Table of Contents for all manual pages](/manualpages/index.md)
[Index of all manual pages](/manualpages/singleindex.md)