---
name: "aegstate"
section: "5"
platform: "linux"
package: "aegis"
version: "4.24.3-3"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/aegstate"
---

# aegstate(5)

aegis global state file

## NAME

aegstate - aegis global state file

## SYNOPSIS

`/var/lib/aegis/state`

## DESCRIPTION

The aegis state file is used to store the pointers to project directories.

## CONTENTS

- where = \[{ ... }\];

  This field is a table relating project name to project directory. The structure is as follows:

  - project\_name = string;

    The name of a project.

  - directory = string;

    Absolute path of the project's directory. (Only set of *alias\_for* is not set.)

  - alias\_for = string;

    This is the name of another project, possibly including branch numbers. It allows you to have shorter or more meaningful project names. (Only set if *directory* is not set.)

## WRITING REPORT SCRIPTS

When attempting to access these fields from within the report generator, you need a code fragment similar to the following:

```
auto p;
p = project[project_name()];
```

That is, the `where` field is represented by the `project` array variable, however, it does not mention the aliases, only the actual projects, similar to the “*ael projects*” command.  (You can, however, index the `projects` array by an alias, or even by a project name with branches on the end.)

In addition to the *project\_name* and *directory* fields specified above, the report generator insets a *state* field, which gives you access to the project state fields (see [*aepstate*(5)](/aepstate/5.md) for more information).

## SEE ALSO

- [*aegis*(5)](/aegis/5.md)

  aegis file format syntax\

## COPYRIGHT

aegis version 4.24.3.D001\
 Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Peter Miller

The aegis program comes with ABSOLUTELY NO WARRANTY; for details use the '*aegis -VERSion License*' command. This is free software and you are welcome to redistribute it under certain conditions; for details use the '*aegis -VERSion License*' command.\

## AUTHOR

| | | |
| --- | --- | --- |
| Peter Miller | E-Mail: | millerp@canb.auug.org.au |
| `/\/\*` | WWW: | http://www.canb.auug.org.au/~millerp/ |