/*

 * Copyright 2007-2009 Sun Microsystems, Inc.  All Rights Reserved.

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

 *

 * This code is free software; you can redistribute it and/or modify it

 * under the terms of the GNU General Public License version 2 only, as

 * published by the Free Software Foundation.  Sun designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Sun in the LICENSE file that accompanied this code.

 *

 * This code is distributed in the hope that it will be useful, but WITHOUT

 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

 * version 2 for more details (a copy is included in the LICENSE file that

 * accompanied this code).

 *

 * You should have received a copy of the GNU General Public License version

 * 2 along with this work; if not, write to the Free Software Foundation,

 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

 *

 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,

 * CA 95054 USA or visit www.sun.com if you need additional information or

 * have any questions.

 */

package java.nio.file.attribute;

import java.util.Set;

/**

 * File attributes associated with files on file systems used by operating systems

 * that implement the Portable Operating System Interface (POSIX) family of

 * standards.

 *

 * <p> The POSIX attributes of a file are retrieved using a {@link

 * PosixFileAttributeView} by invoking its {@link

 * PosixFileAttributeView#readAttributes readAttributes} method.

 *

 * @since 1.7

 *

 * @see Attributes#readPosixFileAttributes

 */

public interface PosixFileAttributes

    extends BasicFileAttributes

{

    /**

     * Returns the owner of the file.

     *

     * @return  The file owner

     *

     * @see PosixFileAttributeView#setOwner

     */

    UserPrincipal owner();

    /**

     * Returns the group owner of the file.

     *

     * @return  The file group owner

     *

     * @see PosixFileAttributeView#setGroup

     */

    GroupPrincipal group();

    /**

     * Returns the permissions of the file. The file permissions are returned

     * as a set of {@link PosixFilePermission} elements. The returned set is a

     * copy of the file permissions and is modifiable. This allows the result

     * to be modified and passed to the {@link PosixFileAttributeView#setPermissions

     * setPermissions} method to update the file's permissions.

     *

     * @return  The file permissions

     *

     * @see PosixFileAttributeView#setPermissions

     */

    Set<PosixFilePermission> permissions();

}