| <?xml version="1.0" encoding="iso-8859-1" standalone="no"?> |
| <!-- Generated by the JDiff Javadoc doclet --> |
| <!-- (http://www.jdiff.org) --> |
| <!-- on Thu Oct 19 21:54:58 UTC 2017 --> |
| |
| <api |
| xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' |
| xsi:noNamespaceSchemaLocation='api.xsd' |
| name="Apache Hadoop HDFS 2.8.2" |
| jdversion="1.0.9"> |
| |
| <!-- Command line arguments = -doclet org.apache.hadoop.classification.tools.IncludePublicAnnotationsJDiffDoclet -docletpath /build/source/hadoop-hdfs-project/hadoop-hdfs/target/hadoop-annotations.jar:/build/source/hadoop-hdfs-project/hadoop-hdfs/target/jdiff.jar -verbose -classpath /build/source/hadoop-hdfs-project/hadoop-hdfs/target/classes:/build/source/hadoop-common-project/hadoop-annotations/target/hadoop-annotations-2.8.2.jar:/usr/lib/jvm/java-7-openjdk-amd64/lib/tools.jar:/build/source/hadoop-common-project/hadoop-auth/target/hadoop-auth-2.8.2.jar:/maven/org/slf4j/slf4j-api/1.7.10/slf4j-api-1.7.10.jar:/maven/org/apache/httpcomponents/httpclient/4.5.2/httpclient-4.5.2.jar:/maven/org/apache/httpcomponents/httpcore/4.4.4/httpcore-4.4.4.jar:/maven/com/nimbusds/nimbus-jose-jwt/3.9/nimbus-jose-jwt-3.9.jar:/maven/net/jcip/jcip-annotations/1.0/jcip-annotations-1.0.jar:/maven/net/minidev/json-smart/1.1.1/json-smart-1.1.1.jar:/maven/org/apache/directory/server/apacheds-kerberos-codec/2.0.0-M15/apacheds-kerberos-codec-2.0.0-M15.jar:/maven/org/apache/directory/server/apacheds-i18n/2.0.0-M15/apacheds-i18n-2.0.0-M15.jar:/maven/org/apache/directory/api/api-asn1-api/1.0.0-M20/api-asn1-api-1.0.0-M20.jar:/maven/org/apache/directory/api/api-util/1.0.0-M20/api-util-1.0.0-M20.jar:/maven/org/apache/zookeeper/zookeeper/3.4.6/zookeeper-3.4.6.jar:/maven/jline/jline/0.9.94/jline-0.9.94.jar:/maven/org/apache/curator/curator-framework/2.7.1/curator-framework-2.7.1.jar:/build/source/hadoop-common-project/hadoop-common/target/hadoop-common-2.8.2.jar:/maven/org/apache/commons/commons-math3/3.1.1/commons-math3-3.1.1.jar:/maven/commons-net/commons-net/3.1/commons-net-3.1.jar:/maven/commons-collections/commons-collections/3.2.2/commons-collections-3.2.2.jar:/maven/org/mortbay/jetty/jetty-sslengine/6.1.26/jetty-sslengine-6.1.26.jar:/maven/javax/servlet/jsp/jsp-api/2.1/jsp-api-2.1.jar:/maven/com/sun/jersey/jersey-json/1.9/jersey-json-1.9.jar:/maven/org/codehaus/jettison/jettison/1.1/jettison-1.1.jar:/maven/com/sun/xml/bind/jaxb-impl/2.2.3-1/jaxb-impl-2.2.3-1.jar:/maven/javax/xml/bind/jaxb-api/2.2.2/jaxb-api-2.2.2.jar:/maven/javax/xml/stream/stax-api/1.0-2/stax-api-1.0-2.jar:/maven/javax/activation/activation/1.1/activation-1.1.jar:/maven/org/codehaus/jackson/jackson-jaxrs/1.9.13/jackson-jaxrs-1.9.13.jar:/maven/org/codehaus/jackson/jackson-xc/1.9.13/jackson-xc-1.9.13.jar:/maven/net/java/dev/jets3t/jets3t/0.9.0/jets3t-0.9.0.jar:/maven/com/jamesmurty/utils/java-xmlbuilder/0.4/java-xmlbuilder-0.4.jar:/maven/commons-configuration/commons-configuration/1.6/commons-configuration-1.6.jar:/maven/commons-digester/commons-digester/1.8/commons-digester-1.8.jar:/maven/commons-beanutils/commons-beanutils/1.7.0/commons-beanutils-1.7.0.jar:/maven/commons-beanutils/commons-beanutils-core/1.8.0/commons-beanutils-core-1.8.0.jar:/maven/org/apache/avro/avro/1.7.4/avro-1.7.4.jar:/maven/com/thoughtworks/paranamer/paranamer/2.3/paranamer-2.3.jar:/maven/org/xerial/snappy/snappy-java/1.0.4.1/snappy-java-1.0.4.1.jar:/maven/com/google/code/gson/gson/2.2.4/gson-2.2.4.jar:/maven/com/jcraft/jsch/0.1.54/jsch-0.1.54.jar:/maven/org/apache/curator/curator-client/2.7.1/curator-client-2.7.1.jar:/maven/org/apache/curator/curator-recipes/2.7.1/curator-recipes-2.7.1.jar:/maven/com/google/code/findbugs/jsr305/3.0.0/jsr305-3.0.0.jar:/maven/org/apache/commons/commons-compress/1.4.1/commons-compress-1.4.1.jar:/maven/org/tukaani/xz/1.0/xz-1.0.jar:/build/source/hadoop-hdfs-project/hadoop-hdfs-client/target/hadoop-hdfs-client-2.8.2.jar:/maven/com/squareup/okhttp/okhttp/2.4.0/okhttp-2.4.0.jar:/maven/com/squareup/okio/okio/1.4.0/okio-1.4.0.jar:/maven/com/google/guava/guava/11.0.2/guava-11.0.2.jar:/maven/org/mortbay/jetty/jetty/6.1.26/jetty-6.1.26.jar:/maven/org/mortbay/jetty/jetty-util/6.1.26/jetty-util-6.1.26.jar:/maven/com/sun/jersey/jersey-core/1.9/jersey-core-1.9.jar:/maven/com/sun/jersey/jersey-server/1.9/jersey-server-1.9.jar:/maven/asm/asm/3.2/asm-3.2.jar:/maven/commons-cli/commons-cli/1.2/commons-cli-1.2.jar:/maven/commons-codec/commons-codec/1.4/commons-codec-1.4.jar:/maven/commons-io/commons-io/2.4/commons-io-2.4.jar:/maven/commons-lang/commons-lang/2.6/commons-lang-2.6.jar:/maven/commons-logging/commons-logging/1.1.3/commons-logging-1.1.3.jar:/maven/commons-daemon/commons-daemon/1.0.13/commons-daemon-1.0.13.jar:/maven/log4j/log4j/1.2.17/log4j-1.2.17.jar:/maven/com/google/protobuf/protobuf-java/2.5.0/protobuf-java-2.5.0.jar:/maven/javax/servlet/servlet-api/2.5/servlet-api-2.5.jar:/maven/org/apache/directory/api/api-i18n/1.0.0-M20/api-i18n-1.0.0-M20.jar:/maven/org/apache/directory/api/api-ldap-model/1.0.0-M20/api-ldap-model-1.0.0-M20.jar:/maven/org/apache/mina/mina-core/2.0.0-M5/mina-core-2.0.0-M5.jar:/maven/net/sf/ehcache/ehcache-core/2.4.4/ehcache-core-2.4.4.jar:/maven/antlr/antlr/2.7.7/antlr-2.7.7.jar:/maven/org/apache/directory/api/api-asn1-ber/1.0.0-M20/api-asn1-ber-1.0.0-M20.jar:/maven/org/slf4j/slf4j-log4j12/1.7.10/slf4j-log4j12-1.7.10.jar:/maven/org/codehaus/jackson/jackson-core-asl/1.9.13/jackson-core-asl-1.9.13.jar:/maven/org/codehaus/jackson/jackson-mapper-asl/1.9.13/jackson-mapper-asl-1.9.13.jar:/maven/xmlenc/xmlenc/0.52/xmlenc-0.52.jar:/maven/io/netty/netty/3.6.2.Final/netty-3.6.2.Final.jar:/maven/io/netty/netty-all/4.0.23.Final/netty-all-4.0.23.Final.jar:/maven/xerces/xercesImpl/2.9.1/xercesImpl-2.9.1.jar:/maven/xml-apis/xml-apis/1.3.04/xml-apis-1.3.04.jar:/maven/org/apache/htrace/htrace-core4/4.0.1-incubating/htrace-core4-4.0.1-incubating.jar:/maven/org/fusesource/leveldbjni/leveldbjni-all/1.8/leveldbjni-all-1.8.jar -sourcepath /build/source/hadoop-hdfs-project/hadoop-hdfs/src/main/java -apidir /build/source/hadoop-hdfs-project/hadoop-hdfs/target/site/jdiff/xml -apiname Apache Hadoop HDFS 2.8.2 --> |
| <package name="org.apache.hadoop.hdfs"> |
| <doc> |
| <![CDATA[<p>A distributed implementation of {@link |
| org.apache.hadoop.fs.FileSystem}. This is loosely modelled after |
| Google's <a href="http://research.google.com/archive/gfs.html">GFS</a>.</p> |
| |
| <p>The most important difference is that unlike GFS, Hadoop DFS files |
| have strictly one writer at any one time. Bytes are always appended |
| to the end of the writer's stream. There is no notion of "record appends" |
| or "mutations" that are then checked or reordered. Writers simply emit |
| a byte stream. That byte stream is guaranteed to be stored in the |
| order written.</p>]]> |
| </doc> |
| </package> |
| <package name="org.apache.hadoop.hdfs.net"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.protocol"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.protocol.datatransfer"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.protocol.datatransfer.sasl"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.protocolPB"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.qjournal.client"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.qjournal.protocol"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.qjournal.protocolPB"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.qjournal.server"> |
| <!-- start interface org.apache.hadoop.hdfs.qjournal.server.JournalNodeMXBean --> |
| <interface name="JournalNodeMXBean" abstract="true" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <method name="getJournalsStatus" return="java.lang.String" |
| abstract="false" native="false" synchronized="false" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <doc> |
| <![CDATA[Get status information (e.g., whether formatted) of JournalNode's journals. |
| |
| @return A string presenting status for each journal]]> |
| </doc> |
| </method> |
| <doc> |
| <![CDATA[This is the JMX management interface for JournalNode information]]> |
| </doc> |
| </interface> |
| <!-- end interface org.apache.hadoop.hdfs.qjournal.server.JournalNodeMXBean --> |
| </package> |
| <package name="org.apache.hadoop.hdfs.security.token.block"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.security.token.delegation"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.balancer"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.blockmanagement"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.common"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.datanode"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.datanode.fsdataset"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.datanode.fsdataset.impl"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.datanode.metrics"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.datanode.web"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.datanode.web.webhdfs"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.mover"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.namenode"> |
| <!-- start interface org.apache.hadoop.hdfs.server.namenode.AuditLogger --> |
| <interface name="AuditLogger" abstract="true" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <method name="initialize" |
| abstract="false" native="false" synchronized="false" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <param name="conf" type="org.apache.hadoop.conf.Configuration"/> |
| <doc> |
| <![CDATA[Called during initialization of the logger. |
| |
| @param conf The configuration object.]]> |
| </doc> |
| </method> |
| <method name="logAuditEvent" |
| abstract="false" native="false" synchronized="false" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <param name="succeeded" type="boolean"/> |
| <param name="userName" type="java.lang.String"/> |
| <param name="addr" type="java.net.InetAddress"/> |
| <param name="cmd" type="java.lang.String"/> |
| <param name="src" type="java.lang.String"/> |
| <param name="dst" type="java.lang.String"/> |
| <param name="stat" type="org.apache.hadoop.fs.FileStatus"/> |
| <doc> |
| <![CDATA[Called to log an audit event. |
| <p> |
| This method must return as quickly as possible, since it's called |
| in a critical section of the NameNode's operation. |
| |
| @param succeeded Whether authorization succeeded. |
| @param userName Name of the user executing the request. |
| @param addr Remote address of the request. |
| @param cmd The requested command. |
| @param src Path of affected source file. |
| @param dst Path of affected destination file (if any). |
| @param stat File information for operations that change the file's |
| metadata (permissions, owner, times, etc).]]> |
| </doc> |
| </method> |
| <doc> |
| <![CDATA[Interface defining an audit logger.]]> |
| </doc> |
| </interface> |
| <!-- end interface org.apache.hadoop.hdfs.server.namenode.AuditLogger --> |
| <!-- start class org.apache.hadoop.hdfs.server.namenode.HdfsAuditLogger --> |
| <class name="HdfsAuditLogger" extends="java.lang.Object" |
| abstract="true" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <implements name="org.apache.hadoop.hdfs.server.namenode.AuditLogger"/> |
| <constructor name="HdfsAuditLogger" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| </constructor> |
| <method name="logAuditEvent" |
| abstract="false" native="false" synchronized="false" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <param name="succeeded" type="boolean"/> |
| <param name="userName" type="java.lang.String"/> |
| <param name="addr" type="java.net.InetAddress"/> |
| <param name="cmd" type="java.lang.String"/> |
| <param name="src" type="java.lang.String"/> |
| <param name="dst" type="java.lang.String"/> |
| <param name="status" type="org.apache.hadoop.fs.FileStatus"/> |
| </method> |
| <method name="logAuditEvent" |
| abstract="false" native="false" synchronized="false" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <param name="succeeded" type="boolean"/> |
| <param name="userName" type="java.lang.String"/> |
| <param name="addr" type="java.net.InetAddress"/> |
| <param name="cmd" type="java.lang.String"/> |
| <param name="src" type="java.lang.String"/> |
| <param name="dst" type="java.lang.String"/> |
| <param name="stat" type="org.apache.hadoop.fs.FileStatus"/> |
| <param name="callerContext" type="org.apache.hadoop.ipc.CallerContext"/> |
| <param name="ugi" type="org.apache.hadoop.security.UserGroupInformation"/> |
| <param name="dtSecretManager" type="org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenSecretManager"/> |
| <doc> |
| <![CDATA[Same as |
| {@link #logAuditEvent(boolean, String, InetAddress, String, String, String, |
| FileStatus)} with additional parameters related to logging delegation token |
| tracking IDs. |
| |
| @param succeeded Whether authorization succeeded. |
| @param userName Name of the user executing the request. |
| @param addr Remote address of the request. |
| @param cmd The requested command. |
| @param src Path of affected source file. |
| @param dst Path of affected destination file (if any). |
| @param stat File information for operations that change the file's metadata |
| (permissions, owner, times, etc). |
| @param callerContext Context information of the caller |
| @param ugi UserGroupInformation of the current user, or null if not logging |
| token tracking information |
| @param dtSecretManager The token secret manager, or null if not logging |
| token tracking information]]> |
| </doc> |
| </method> |
| <method name="logAuditEvent" |
| abstract="true" native="false" synchronized="false" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <param name="succeeded" type="boolean"/> |
| <param name="userName" type="java.lang.String"/> |
| <param name="addr" type="java.net.InetAddress"/> |
| <param name="cmd" type="java.lang.String"/> |
| <param name="src" type="java.lang.String"/> |
| <param name="dst" type="java.lang.String"/> |
| <param name="stat" type="org.apache.hadoop.fs.FileStatus"/> |
| <param name="ugi" type="org.apache.hadoop.security.UserGroupInformation"/> |
| <param name="dtSecretManager" type="org.apache.hadoop.hdfs.security.token.delegation.DelegationTokenSecretManager"/> |
| <doc> |
| <![CDATA[Same as |
| {@link #logAuditEvent(boolean, String, InetAddress, String, String, |
| String, FileStatus, CallerContext, UserGroupInformation, |
| DelegationTokenSecretManager)} without {@link CallerContext} information.]]> |
| </doc> |
| </method> |
| <doc> |
| <![CDATA[Extension of {@link AuditLogger}.]]> |
| </doc> |
| </class> |
| <!-- end class org.apache.hadoop.hdfs.server.namenode.HdfsAuditLogger --> |
| <!-- start class org.apache.hadoop.hdfs.server.namenode.INodeAttributeProvider --> |
| <class name="INodeAttributeProvider" extends="java.lang.Object" |
| abstract="true" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <constructor name="INodeAttributeProvider" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| </constructor> |
| <method name="start" |
| abstract="true" native="false" synchronized="false" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <doc> |
| <![CDATA[Initialize the provider. This method is called at NameNode startup |
| time.]]> |
| </doc> |
| </method> |
| <method name="stop" |
| abstract="true" native="false" synchronized="false" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <doc> |
| <![CDATA[Shutdown the provider. This method is called at NameNode shutdown time.]]> |
| </doc> |
| </method> |
| <method name="getAttributes" return="org.apache.hadoop.hdfs.server.namenode.INodeAttributes" |
| abstract="false" native="false" synchronized="false" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <param name="fullPath" type="java.lang.String"/> |
| <param name="inode" type="org.apache.hadoop.hdfs.server.namenode.INodeAttributes"/> |
| </method> |
| <method name="getAttributes" return="org.apache.hadoop.hdfs.server.namenode.INodeAttributes" |
| abstract="true" native="false" synchronized="false" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <param name="pathElements" type="java.lang.String[]"/> |
| <param name="inode" type="org.apache.hadoop.hdfs.server.namenode.INodeAttributes"/> |
| </method> |
| <method name="getAttributes" return="org.apache.hadoop.hdfs.server.namenode.INodeAttributes" |
| abstract="false" native="false" synchronized="false" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <param name="components" type="byte[][]"/> |
| <param name="inode" type="org.apache.hadoop.hdfs.server.namenode.INodeAttributes"/> |
| </method> |
| <method name="getExternalAccessControlEnforcer" return="org.apache.hadoop.hdfs.server.namenode.INodeAttributeProvider.AccessControlEnforcer" |
| abstract="false" native="false" synchronized="false" |
| static="false" final="false" visibility="public" |
| deprecated="not deprecated"> |
| <param name="defaultEnforcer" type="org.apache.hadoop.hdfs.server.namenode.INodeAttributeProvider.AccessControlEnforcer"/> |
| <doc> |
| <![CDATA[Can be over-ridden by implementations to provide a custom Access Control |
| Enforcer that can provide an alternate implementation of the |
| default permission checking logic. |
| @param defaultEnforcer The Default AccessControlEnforcer |
| @return The AccessControlEnforcer to use]]> |
| </doc> |
| </method> |
| </class> |
| <!-- end class org.apache.hadoop.hdfs.server.namenode.INodeAttributeProvider --> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.namenode.ha"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.namenode.metrics"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.namenode.snapshot"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.namenode.top"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.namenode.top.metrics"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.namenode.top.window"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.namenode.web.resources"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.server.protocol"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.tools"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.tools.offlineEditsViewer"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.tools.offlineImageViewer"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.tools.snapshot"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.util"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.web"> |
| </package> |
| <package name="org.apache.hadoop.hdfs.web.resources"> |
| </package> |
| |
| </api> |