---
name: "alliancebanner"
section: "3"
platform: "linux"
package: "alliance"
version: "5.1.1-3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/alliancebanner"
---

# alliancebanner(3)

display the standardized Alliance banner

## NAME

alliancebanner - display the standardized Alliance banner

## SYNOPSYS

```
#include "mut.h"
void alliancebanner(tool, tv, comment, date, av)
char ∗tool, ∗tv, ∗comment, ∗date, ∗av;
```

## PARAMETERS

- ***tool***

  Name of the tool. This is what will be displayed as banner.

- ***tv***

  Tool version.

- ***comment***

  Indicates the tool's usefulness.

- ***date***

  Copyright dates.

- ***av***

  Alliance version.

## DESCRIPTION

**alliancebanner** ouputs on ***stdout*** a standardized banner with the name of the tool in large letters, and a cartouche containing some informations about the Alliance CAD system. This function is to be used by all the Alliance tools, and expect a display 80 columns wide.

## EXAMPLE

```
#include "ba315n.h"
#define nfloptitle(name) \
        alliancebanner("nFloP", VERSION,\
                       "not a FloorPlan router", "92, 93",\
                       ALLIANCE_VERSION)
```

## SEE ALSO

**alliance**(1).

## DIAGNOSTICS

***alliancebanner: Error: Resulting size bigger than 80 columns not allowed***

The *tool* argument must be such that its resulting size isn't wider that 80 culumns. This means, since the character set is proportional, that the longest name to be output is about 8 characters long.

***alliancebanner: Error: Character out of \[0-9A-Za-z\] range***

The *tool* parameter has a non allowed character in it. For simplicity purposes, only numbers and letters are accepted.