Skip to content

doveadm: Remove '-A' parameter #1326

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
slusarz wants to merge 1 commit into
base: main
Choose a base branch
from
Open

doveadm: Remove '-A' parameter #1326

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/core/admin/doveadm.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -293,7 +293,7 @@ guarantees that two backend servers don't attempt to modify the same user's
mailbox at the same time (which might cause problems).

::: warning [[changed,doveadm_mailbox_commands_user]]
All mail commands require providing `-u`, `-F` or `-A` parameter.
All mail commands require providing `-u` or `-F` parameter.

`USER` environment variable is no longer supported.

Expand Down
2 changes: 1 addition & 1 deletion docs/core/config/auth/databases/ldap.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -395,7 +395,7 @@ userdb ldap {

### User Iteration

For using `doveadm -A` or `-u` with wildcards:
For using `doveadm -u` with wildcards:
```
ldap_uris = ldap://ldap.example.org
ldap_auth_dn = cn=admin,dc=example,dc=org
Expand Down
2 changes: 1 addition & 1 deletion docs/core/config/auth/databases/lua.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -340,7 +340,7 @@ end
```

If you also want to be able to list users, so that you could use
`doveadm cmd -A`:
`doveadm cmd -u "*"`:

```lua:line-numbers
local database = "/path/to/file"
Expand Down
8 changes: 4 additions & 4 deletions docs/core/config/auth/databases/sql.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -111,7 +111,7 @@ mail_gid = vmail

## User Iteration

Some commands, such as `doveadm -A` need to get a list of users. With SQL
Some commands (using `-u "*"`) need to get a list of users. With SQL
userdb this is done with the [[setting,userdb_sql_iterate_query]] setting.

You can either return:
Expand Down Expand Up @@ -195,7 +195,7 @@ userdb sql {
query = SELECT home, uid, gid \
FROM users \
WHERE userid = '%{user | username}' AND domain = '%{user | domain}'
# For using doveadm -A:
# For using doveadm -u "*":
iterate_query = SELECT userid AS username, domain FROM users
}
```
Expand Down Expand Up @@ -226,7 +226,7 @@ userdb sql {
query = SELECT home, uid, gid \
FROM users \
WHERE userid = '%{user | username}' AND domain = '%{user | domain}'
# For using doveadm -A:
# For using doveadm -u "*":
iterate_query = SELECT userid AS username, domain FROM users
}
```
Expand All @@ -248,7 +248,7 @@ userdb sql {
query = SELECT home, uid, gid \
FROM users \
WHERE userid = '%{user | username}' AND domain = '%{user | domain}'
# For using doveadm -A:
# For using doveadm -u "*":
iterate_query = SELECT userid AS username, domain FROM users
}
```
18 changes: 8 additions & 10 deletions docs/core/man/doveadm-acl.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,6 @@ This command uses by default the output formatter **table**.

## OPTIONS

<!-- @include: include/option-A.inc -->

<!-- @include: include/option-F-file.inc -->

<!-- @include: include/option-no-userdb-lookup.inc -->
Expand Down Expand Up @@ -116,7 +114,7 @@ This command uses by default the output formatter **table**.
### acl add

**doveadm** [*GLOBAL OPTIONS*] acl add
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
*mailbox id* *right*
[*right* ...]
Expand All @@ -127,7 +125,7 @@ existing rights are preserved.
### acl debug

**doveadm** [*GLOBAL OPTIONS*] acl debug
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
*mailbox*

Expand All @@ -137,7 +135,7 @@ to the user. It will list exactly what the problem is.
### acl delete

**doveadm** [*GLOBAL OPTIONS*] acl delete
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
*mailbox id*

Expand All @@ -146,7 +144,7 @@ Remove the whole ACL entry for the *mailbox*/*id*.
### acl get

**doveadm** [*GLOBAL OPTIONS*] acl get
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
[**-m**]
*mailbox*
Expand All @@ -159,7 +157,7 @@ Show all the ACLs for the *mailbox*.
### acl recalc

**doveadm** [*GLOBAL OPTIONS*] acl recalc
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]

Make sure the *user*'s shared mailboxes exist correctly in the
Expand All @@ -168,7 +166,7 @@ Make sure the *user*'s shared mailboxes exist correctly in the
### acl remove

**doveadm** [*GLOBAL OPTIONS*] acl remove
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
*mailbox id* *right* [*right* ...]

Expand All @@ -178,7 +176,7 @@ are removed, the entry still exists without any rights.
### acl rights

**doveadm** [*GLOBAL OPTIONS*] acl rights
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
*mailbox*

Expand All @@ -187,7 +185,7 @@ Show the *user*'s current ACL rights for the *mailbox*.
### acl set

**doveadm** [*GLOBAL OPTIONS*] acl set
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
*mailbox id* *right* [*right* ...]

Expand Down
7 changes: 0 additions & 7 deletions docs/core/man/doveadm-altmove.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,6 @@ dovecotComponent: core

## SYNOPSIS

**doveadm** [*GLOBAL OPTIONS*] **altmove**
[**-r**]
[**-S** *socket_path*]
**-A** *search_query*

**doveadm** [*GLOBAL OPTIONS*] **altmove**
[**-r**]
[**-S** *socket_path*]
Expand Down Expand Up @@ -49,8 +44,6 @@ moved to the alternative storage.

## OPTIONS

<!-- @include: include/option-A.inc -->

<!-- @include: include/option-F-file.inc -->

<!-- @include: include/option-no-userdb-lookup.inc -->
Expand Down
4 changes: 1 addition & 3 deletions docs/core/man/doveadm-deduplicate.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ dovecotComponent: core
## SYNOPSIS

**doveadm** [*GLOBAL OPTIONS*] **deduplicate**
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
[**-m**]
*search_query*
Expand All @@ -28,8 +28,6 @@ Deduplication across multiple mailboxes is not supported.

## OPTIONS

<!-- @include: include/option-A.inc -->

<!-- @include: include/option-F-file.inc -->

<!-- @include: include/option-no-userdb-lookup.inc -->
Expand Down
7 changes: 0 additions & 7 deletions docs/core/man/doveadm-expunge.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,6 @@ dovecotComponent: core

## SYNOPSIS

**doveadm** [*GLOBAL OPTIONS*] **expunge**
[**-S** *socket_path*]
[**-d**]
**-A** *search_query*

**doveadm** [*GLOBAL OPTIONS*] **expunge**
[**-S** *socket_path*]
[**-d**]
Expand Down Expand Up @@ -50,8 +45,6 @@ expunged.

## OPTIONS

<!-- @include: include/option-A.inc -->

**-d**
: Delete the mailbox if it is empty after expunging.

Expand Down
4 changes: 1 addition & 3 deletions docs/core/man/doveadm-fetch.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ dovecotComponent: core

**doveadm** [*GLOBAL OPTIONS*] [**-f** *formatter*] **fetch**
[**-S** *socket_path*]
**-A** *fields* *search_query*
*fields* *search_query*

**doveadm** [*GLOBAL OPTIONS*] [**-f** *formatter*] **fetch**
[**-S** *socket_path*]
Expand Down Expand Up @@ -38,8 +38,6 @@ This command uses by default the output formatter **pager**.

## OPTIONS

<!-- @include: include/option-A.inc -->

<!-- @include: include/option-F-file.inc -->

<!-- @include: include/option-no-userdb-lookup.inc -->
Expand Down
10 changes: 4 additions & 6 deletions docs/core/man/doveadm-flags.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ dovecotComponent: core

**doveadm** [*GLOBAL OPTIONS*] **flags**
[**-S** *socket_path*]
**-A** *command flags* *search_query*
*command flags* *search_query*

**doveadm** [*GLOBAL OPTIONS*] **flags**
[**-S** *socket_path*]
Expand All @@ -32,8 +32,6 @@ This command is used to manipulate flags of messages.

## OPTIONS

<!-- @include: include/option-A.inc -->

<!-- @include: include/option-F-file.inc -->

<!-- @include: include/option-no-userdb-lookup.inc -->
Expand Down Expand Up @@ -62,7 +60,7 @@ This command is used to manipulate flags of messages.
### flags add

**doveadm** [*GLOBAL OPTIONS*] flags add
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
*flags search_query*

Expand All @@ -72,7 +70,7 @@ This command is used to extend the current set of flags with the given
### flags remove

**doveadm** [*GLOBAL OPTIONS*] flags remove
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
*flags search_query*

Expand All @@ -82,7 +80,7 @@ this command.
### flags replace

**doveadm** [*GLOBAL OPTIONS*] flags replace
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
*flags search_query*

Expand Down
6 changes: 0 additions & 6 deletions docs/core/man/doveadm-force-resync.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,6 @@ dovecotComponent: core

## SYNOPSIS

**doveadm** [*GLOBAL OPTIONS*] **force-resync**
[**-S** *socket_path*]
**-A** *mailbox*

**doveadm** [*GLOBAL OPTIONS*] **force-resync**
[**-S** *socket_path*]
**-F** *file* *mailbox*
Expand All @@ -36,8 +32,6 @@ also checked.

## OPTIONS

<!-- @include: include/option-A.inc -->

<!-- @include: include/option-F-file.inc -->

<!-- @include: include/option-no-userdb-lookup.inc -->
Expand Down
6 changes: 2 additions & 4 deletions docs/core/man/doveadm-fts.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,6 @@ This command uses by default the output formatter **flow** (without the

## OPTIONS

<!-- @include: include/option-A.inc -->

<!-- @include: include/option-F-file.inc -->

<!-- @include: include/option-no-userdb-lookup.inc -->
Expand All @@ -43,7 +41,7 @@ This command uses by default the output formatter **flow** (without the
### fts optimize

**doveadm** [*GLOBAL OPTIONS*] fts optimize
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
[*namespace*]

Expand All @@ -53,7 +51,7 @@ the full text search engines, but this enforces it to happen.
### fts rescan

**doveadm** [*GLOBAL OPTIONS*] fts rescan
[**-u** *user* | **-A** | **-F** *file* | **\-\-no-userdb-lookup**]
[**-u** *user* | **-F** *file* | **\-\-no-userdb-lookup**]
[**-S** *socket_path*]
[*namespace*]

Expand Down
9 changes: 0 additions & 9 deletions docs/core/man/doveadm-import.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,6 @@ dovecotComponent: core

## SYNOPSIS

**doveadm** [*GLOBAL OPTIONS*] **import**
[**-S** *socket_path*]
[**-U** *source_user*]
[**-s**]
**-A**
*source_mail_driver*:*source_mail_path*

**doveadm** [*GLOBAL OPTIONS*] **import**
[**-S** *socket_path*]
[**-U** *source_user*]
Expand Down Expand Up @@ -58,8 +51,6 @@ In the final form, the mails will be imported only for given *user* (s).

## OPTIONS

<!-- @include: include/option-A.inc -->

<!-- @include: include/option-F-file.inc -->

<!-- @include: include/option-no-userdb-lookup.inc -->
Expand Down
9 changes: 0 additions & 9 deletions docs/core/man/doveadm-index.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,6 @@ dovecotComponent: core

## SYNOPSIS

**doveadm** [*GLOBAL OPTIONS*] **index**
[**-S** *socket_path*]
**-A**
[**-q**]
[**-n** *max_recent*]
*mailbox*

**doveadm** [*GLOBAL OPTIONS*] **index**
[**-S** *socket_path*]
**-F** *file*
Expand Down Expand Up @@ -59,8 +52,6 @@ fts_autoindex = yes

## OPTIONS

<!-- @include: include/option-A.inc -->

<!-- @include: include/option-F-file.inc -->

**-n** *max_recent*
Expand Down
2 changes: 0 additions & 2 deletions docs/core/man/doveadm-mailbox-cryptokey.1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,6 @@ active.

## OPTIONS

<!-- @include: include/option-A.inc -->

<!-- @include: include/option-F-file.inc -->

<!-- @include: include/option-no-userdb-lookup.inc -->
Expand Down
Loading