Property:declare

---

BoxMatrix >> Shell-Commands >> declare

@ BoxMatrix   -   IRC-Chat   -   Translate: de es fr it nl pl

News

Selectors

Models

Accessories

Components

Environment

Config

Commands

System

Webif

Software

Develop

Lexicon

Community

Project

Media

---

Startup-Scr

Hotplug-Scr

BusyBox-Cmds

Bash-Cmds

AVM-Cmds

Chipset-Cmds

Linux-Cmds

Shared-Libs

Kernel-Mods

Research

---

Bash-Command

Command:	declare   -   type bash	Wiki	Freetz	IPPF	whmf	AVM	Web
Location:	Shell-Commands >> Bash-Commands   -   Origin: Bash
Path:	Release: <bash> Lab+Rel: <bash>
Properties:	Size:   -   Firmware: 7.04 - 8.00
Function:	Set variable values and attributes.

Goto:   GPL-Browser  -  Dependencies   -   Model-Matrix   -   Symbols   -   SMW-Browser

Details

Excerpt from:   Bash source   >>   declare command

Possible #if / #endif blocks are compile options. There is no mechanism yet on BoxMatrix to detect which of these are set per model.

declare [-aAfFgilnrtux] [-p] [name[=value] ...]

Set variable values and attributes.

Declare variables and give them attributes.  If no NAMEs are given,
display the attributes and values of all variables.

Options:
  -f    restrict action or display to function names and definitions
  -F    restrict display to function names only (plus line number and
        source file when debugging)
  -g    create global variables when used in a shell function; otherwise
        ignored
  -p    display the attributes and value of each NAME

Options which set attributes:
  -a    to make NAMEs indexed arrays (if supported)
  -A    to make NAMEs associative arrays (if supported)
  -i    to make NAMEs have the `integer' attribute
  -l    to convert NAMEs to lower case on assignment
  -n    make NAME a reference to the variable named by its value
  -r    to make NAMEs readonly
  -t    to make NAMEs have the `trace' attribute
  -u    to convert NAMEs to upper case on assignment
  -x    to make NAMEs export

Using `+' instead of `-' turns off the given attribute.

Variables with the integer attribute have arithmetic evaluation (see
the `let' command) performed when the variable is assigned a value.

When used in a function, `declare' makes NAMEs local, as with the `local'
command.  The `-g' option suppresses this behavior.

Exit Status:
Returns success unless an invalid option is supplied or a variable
assignment error occurs.

Excerpt from:   bashref.info   >>   Bash Builtins   >>   declare command

declare [-aAfFgilnrtux] [-p] [NAME[=VALUE] ...]

Declare variables and give them attributes.  If no NAMEs are given,
then display the values of variables instead.

The '-p' option will display the attributes and values of each
NAME.  When '-p' is used with NAME arguments, additional options,
other than '-f' and '-F', are ignored.

When '-p' is supplied without NAME arguments, 'declare' will
display the attributes and values of all variables having the
attributes specified by the additional options.  If no other
options are supplied with '-p', 'declare' will display the
attributes and values of all shell variables.  The '-f' option will
restrict the display to shell functions.

The '-F' option inhibits the display of function definitions; only
the function name and attributes are printed.  If the 'extdebug'
shell option is enabled using 'shopt' (*note The Shopt Builtin::),
the source file name and line number where each NAME is defined are
displayed as well.  '-F' implies '-f'.

The '-g' option forces variables to be created or modified at the
global scope, even when 'declare' is executed in a shell function.
It is ignored in all other cases.

The following options can be used to restrict output to variables
with the specified attributes or to give variables attributes:

-a
     Each NAME is an indexed array variable (*note Arrays::).

-A
     Each NAME is an associative array variable (*note Arrays::).

-f
     Use function names only.

-i
     The variable is to be treated as an integer; arithmetic
     evaluation (*note Shell Arithmetic::) is performed when the
     variable is assigned a value.

-l
     When the variable is assigned a value, all upper-case
     characters are converted to lower-case.  The upper-case
     attribute is disabled.

-n
     Give each NAME the NAMEREF attribute, making it a name
     reference to another variable.  That other variable is defined
     by the value of NAME.  All references, assignments, and
     attribute modifications to NAME, except for those using or
     changing the '-n' attribute itself, are performed on the
     variable referenced by NAME's value.  The nameref attribute
     cannot be applied to array variables.

-r
     Make NAMEs readonly.  These names cannot then be assigned
     values by subsequent assignment statements or unset.

-t
     Give each NAME the 'trace' attribute.  Traced functions
     inherit the 'DEBUG' and 'RETURN' traps from the calling shell.
     The trace attribute has no special meaning for variables.

-u
     When the variable is assigned a value, all lower-case
     characters are converted to upper-case.  The lower-case
     attribute is disabled.

-x
     Mark each NAME for export to subsequent commands via the
     environment.

Using '+' instead of '-' turns off the attribute instead, with the
exceptions that '+a' may not be used to destroy an array variable
and '+r' will not remove the readonly attribute.  When used in a
function, 'declare' makes each NAME local, as with the 'local'
command, unless the '-g' option is used.  If a variable name is
followed by =VALUE, the value of the variable is set to VALUE.

When using '-a' or '-A' and the compound assignment syntax to
create array variables, additional attributes do not take effect
until subsequent assignments.

The return status is zero unless an invalid option is encountered,
an attempt is made to define a function using '-f foo=bar', an
attempt is made to assign a value to a readonly variable, an
attempt is made to assign a value to an array variable without
using the compound assignment syntax (*note Arrays::), one of the
NAMES is not a valid shell variable name, an attempt is made to
turn off readonly status for a readonly variable, an attempt is
made to turn off array status for an array variable, or an attempt
is made to display a non-existent function with '-f'.

GPL-Browser

Daily updated index of all declare code findings on the GPL-Browser. Last update: 2025-01-09 05:00 GMT.
The Browse column points to the Path containing the respective source code on the gpl.boxmatrix.info service.
The SoC column lists the Chip-Codenames, the Model column lists the nicks of the Box-Models.
The Diff column links the comparison of the AVM Kernel to the pristine original from Kernel.org.
The Download column links the full tarball the respective directory content is extracted from.
The presence of the source does not mean it fits the respective model and architecture. See the Model-Matrix where it's used.

Browse	Path	SoC	Arch	Model	Firmw	Diff	Download
puma7-atom-6591-750	packages/bash-4.4.18/builtins	Puma7	ATOM	6591	7.50	4.9.279	Download
puma7-atom-6670-761	packages/bash-5.1.16/builtins	Puma7	ATOM	6670	7.61	5.15.111	Download
2 directories containing declare source code

Dependencies

Daily updated index of all dependencies of this command. Last update: 2025-01-09 07:36 GMT.
A * in the Mod column marks info from Supportdata-Probes, which will always stay incomplete.

Relation	Typ	Object	Mod	Firmware	Info	Origin
0 dependencies for this command

Model-Matrix

Daily updated index of the presence, path and size of this command for each model. Last update: 2025-01-09 05:37 GMT.
Showing all models using this command. Click any column header (click-wait-click) to sort the list by the respective data.
The (main/scrpn/boot/arm/prx/atom/rtl) label in the Model column shows which CPU is meant for Multi-Linux models.
Note that this list is merged from Firmware-Probes of all known AVM firmware for a model, including Recovery.exe and Labor-Files.

Model	Firmware	Path	Size
FRITZ!Box 6591 Cable (atom)	7.04 - 8.00	<bash>
FRITZ!Box 6660 Cable (atom)	7.14 - 8.00	<bash>
FRITZ!Box 6670 Cable (atom)	7.61 - 7.90	<bash>
FRITZ!Box 6690 Cable (atom)	7.28 - 7.90	<bash>
4 models use this command

Symbols

Daily updated index of all symbols of this command. Last update: 2025-01-09 07:36 GMT.

Firmware	Symbol
0 symbols for this command

SMW-Browser

Property:declare

Information is currently being retrieved from the backend.