syntax:
:

    ```xml
    <path-permission android:path="string"
                     android:pathPrefix="string"
                     android:pathPattern="string"
                     android:permission="string"
                     android:readPermission="string"
                     android:writePermission="string" />
    ```

contained in:
:   [<provider>](https://developer.android.com/guide/topics/manifest/provider-element)

description:
:   Defines the path and required permissions for a specific subset of data
    within a content provider. This element can be
    specified multiple times to supply multiple paths.

attributes:
:

    `android:path`
    :   A complete URI path for a subset of content provider data.
        Permission can be granted only to the particular data identified by this path.
        When used to provide search suggestion content, it is appended
        with `/search_suggest_query`.

    `android:pathPrefix`
    :   The initial part of a URI path for a subset of content provider data.
        Permission can be granted to all data subsets with paths that share this initial part.

    `android:pathPattern`
    :   A complete URI path for a subset of content provider data,
        but one that can use the following wildcards:

        - An asterisk (`*`). This matches a sequence of zero to many occurrences of the immediately preceding character.
        - A period followed by an asterisk (`.*`). This matches any sequence of zero or more characters.


        Because the backslash (`\`) is used as an escape character when the string is read
        from XML, before it is parsed as a pattern, you need to double-escape.
        For example, a literal `*` is written as "`\\*`" and a
        literal `\` is written as "`\\\`". This is
        the same as what you write if constructing the string in the Java programming language.


        For more information about these types of patterns, see the descriptions of
        [`PATTERN_LITERAL`](https://developer.android.com/reference/android/os/PatternMatcher#PATTERN_LITERAL),
        [`PATTERN_PREFIX`](https://developer.android.com/reference/android/os/PatternMatcher#PATTERN_PREFIX), and
        [`PATTERN_SIMPLE_GLOB`](https://developer.android.com/reference/android/os/PatternMatcher#PATTERN_SIMPLE_GLOB) in the
        [`PatternMatcher`](https://developer.android.com/reference/android/os/PatternMatcher) class.

    `android:permission`
    :   The name of a permission that clients need in order to read or write the
        content provider's data. This attribute is a convenient way of setting a
        single permission for both reading and writing. However, the
        `readPermission` and
        `writePermission` attributes take precedence
        over this one.

    `android:readPermission`
    :   A permission that clients need in order to query the content provider.

    `android:writePermission`
    :   A permission that clients need in order to make changes to the data controlled by the content provider.

introduced in:
:   API level 4

see also:
:   [SearchManager](https://developer.android.com/reference/android/app/SearchManager)
:   [Manifest.permission](https://developer.android.com/reference/android/Manifest.permission)
:   [Security tips](https://developer.android.com/guide/topics/security/security)