# blocking: entities blocking

`blocking` are commands to block or unblock users by their JIDs (as specified by XEP-0191). You server must implement this XEP to use those commands.

A blocking is usually done using bare JID, however, you may specify a resource if you want to block only this resource, or a domain if you want to block a whole domain. Please check XEP-0191 § JID Matching for details.

## list

List already blocked users.

### examples

Check who has already been blocked:

    $ li blocking list

## block

Block one or more entities by specifying their JIDs.

You just need to specify the bare JIDs of users that you want to block as positional argument, specify only a domain if you want to block a whole domain.

### examples

Louise wants to block `spammer@example.com` and the whole domain `spammers.example`:

    $ li blocking block spammer@example.com spammers.example

## unblock

`unblock` works the same way as `block`.

If you want to unblock all blocked users at once, you can use the `all` keyword. In this case, you’ll have to confirm the action. If you don’t want to confirm manually, you can use the `-f, --force` flag.

### examples

Pierre wants to unblock the domain `example.com` that he has blocked earlier:

    $ li blocking unblock example.com

Élysée want to unblock all blocked users, without confirmation:

    $ li blocking unblock -f all